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PREFACE 


This book is a detailed description of the Multics Emacs 
text editor, a real-time editing and formatting system designed 
for use on video terminals. It is intended for all users; both 
those who have relatively little experience on the Multics 
operating system (or any other computer system) and experienced 
programmers will find this a complete description. Users are, 
however, expected to be familiar with the Multics concepts 
described in the 2~volume set, New Users' Introduction to Multics 
-~ Part I (Order No. CH24), and -= Part II (Order No. CH25), 


referred to in this manual as New Users' Introduction. 


Although Multics Emacs is easily used by technically 
inexperienced people, those with some programming experience can 
utilize it even more effectively by writing their own extensions. 
Examples of supplied extensions are the Emacs message subsystem 
and the various language modes, described in Appendices B and © 
of this manual. Information about extensions and instructions 
for writing them are provided in the Emacs Extension Writers' 
Guide, Order No. CJ52, which is referred to in this book as 
Extension Writers' Guide. 





Many video terminal types are supported by Emacs, as 
supplied. Information on how to support additional terminal 
types is also available in the Extension Writers' Guide. It is 
recommended that at least one person at your site have a copy; 
someone should also be familiar with the Emacs installatzon 
information. 


The term "file" is used interchangeably with "segment" in 
this manual, since many of the editing requests have the word 
"file" as part of their command names. 
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The sections of this manual fully describe the Emacs editor 
and explain the steps required to edit effectively any type of 
user text. In general, the basic techniques are explained first; 
more powerful or efficient requests are introduced as you proceed 
through this book. The first sixteen sections are tutorial; 
section 17 Summarizes, by editing function, all the Fundamental 
mode requests, including both those described in the tutorial and 
some additional requests that are used less frequently. 


section 1 is a brief introduction. 


section 2 describes how to begin: using the terminal, 
logging into the Multics system, and entering the Multics 
environment. 


section 3 tells how to enter text, move the cursor, make 
simple corrections, and log out. 


section 4 describes afew requests for deleting text and 
retrieving deleted text. 


Section 5 explains how to read and write files (segments). 


Section 6 describes some simple search requests for locating 
character strings. 


section 7 introduces requests for manipulating blocks of 
texts. 


Section 8 describes numeric arguments and various other ways 
to reexecute editing requests. 


section 9 defines an Emacs "word" and describes the requests 
that operate on words. 


Section 10 deals with screens and buffers, telling how to 


display different areas of the buffer on your screen, how to 
Switch buffers, list them, and delete them. 
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section 11 includes the help facilities available on Emacs. 
The editor is completely documented online, so information is 
always available during editing. 


section i2 defines Emacs sentences and paragraphs, and 
describes requests that operate on them. 


Section 13 includes many requests for handling white space, 
indentation, and formatting. 


Section 14 gives more information on manipulating blocks of 
text, inserting files, and using named regions and marks. 


section 15 describes keyboard macros that can easily be 
created to perform special editing tasks. 


Section 16 describes the use of multiple windows, the window 
editor, and the buffer editor. 


Section 17 contains descriptions of all the Fundamental mode 
requests, arranged by function. 


Appendix A documents the emacs command and lists, 
alphabetically, all the Fundamental mode requests. 


Appendix B describes the Emacs mail mode for sending and 
reading electronic mail. 


Appendix cC describes the Emacs programming language modes 
and their requests, which are tailored for use in writing and 
editing programs in Lisp, FORTRAN, PL/I, and ALM. 


Appendix D describes the Macro Edit mode for editing 
keyboard macros. 


Appendix E gives instructions for using Emacs on printing 
and glass teletype terminals. 


Appendix F describes the kmacs message facility for 
accepting and responding to interactive messages. 
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Appendix G details how to write an Emacs’) start-up to 
customize the environment automatically each time Emacs is 


entered. 


Appendix H describes pop-up-windows mode, which dynamically 
creates and removes windows as they are needed. 


One other manual referred to in this book is the 


Multics Programmers’ Manual (MPM)-—Commands and Active Functions, 
Order No. AG92. It is referred to as the MPM Commands. 


Multics Emacs was modelled after the EMACS editor at the MIT 
Artificial Intelligence Lab. EMACS (on the AI Lab PDP-10's) was 
written, in TECO, by staff, members of the MIT AI Lab and the 
(MIT) Laboratory for Computer Science (LCS), without whose 
encouragement and support this project would not have been 


possible. 
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SECTION 1 


INTRODUCTION 


Multics HEmacs is an integrated editing, text preparation, 
and screen management system designed to take advantage of the 
features of modern display terminals. Text entry and editing on 
these video screen display terminals are done interactively. 
You, the user, can see the effects of Emacs editing on the screen 
as you type. 


This manual is arranged so that you, as a new Emacs user, 
can learn Emacs by immediately beginning to use it. The first 
part, Sections 2 through 16, are tutorial in nature, and cover 
text entry and the more basic Emacs requests. Section 17 
Summarizes the requests covered in the preceding sections, and 
introduces the remaining Fundamental mode (basic Emacs mode) 
requests. Advanced users’ should immediately turn to this 
section, which provides short descriptions of every Fundamental 
mode request. The requests are presented there in functional 
groups, i.e., for a particular type of editing task, all the 
requests available to perform that task are described. 


Users who work through the first sixteen sections will also 
find Section 17 useful for reference and for learning the 
additional requests not covered in the tutorial. 


The appendices describe specialized uses of Emacs, including 
the Emacs mail system and programming language modes. Appendix A 
provides the emacs command description, and an alphabetized list 
of the Fundamental mode requests. 


Throughout this manual, "Emacs" designates the systen, and 
the all lowercase "emacs" designates the Multics command invoked 
to use the system. 
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SECTION 2 


GETTING STARTED 


THE TERMINAL 

Although it can be used on printing terminals, Emacs has 
been designed especially for use on screen terminals. Sit down 
at your screen terminal and note the three parts you will be 
using as you edit: 

e the screen 

the keyboard 

e the modem communicating between the terminal and Multics 

Figure 2-1 shows a typical screen terminal and Figure 2-2 
shows a typical keyboard and the special keys described below. 
The Screen 

The screen of your terminal is like a television screen, and 
displays the information needed to communicate with Multics and 


Emacs. Messages from the system appear on the screen, and your 
responses, typed on the keyboard, also appear. 


2— | CH27-00 


"|-c aInsty 


TBVulWIey, useei0g VY 



















































































































































































































































































CH2'7-O0 





a fn hahaha fata aii aS SS A A AAR A we Ne ee rN 
Aare ene men Ne Ns i A A A Ada a I Sa A 
a SS SSS SS SA ss As Pen Ne a 


CC 


OO~LCHO 


CONTROL KEY 


DELETE KEY 


Figure 2-2. 






ESCAPE KEY 


LINEFEED KEY 


CARRIAGE RETURN KEY 





A Terminal Keyboard 





The Keyboard 


Your keyboard resembles the keyboard of a typewriter, with 
its letters and special characters, but has additional keys. 
Several of them are important for Emacs usage. They include the 
following: 

e control key 
escape key 
linefeed key 


delete key 


carriage return key 


CONTROL KEY 


Terminals vary, but you should be able to locate a key 
labelled with the letters CTL, CTRL, CONTROL, CNTRL, or something 
Similar. This is the control key. It operates like a shift key 
in that it must be held down while you hit one or more normal 
characters. Simply pressing it and releasing it has no effect. 
For example, if you press the "p" key, you get a lowercase p. If 
you press the "p" key while holding down the shift key, you get 
an uppercase P. If you press the "p" key while holding down the 
control key, you get something called a control P. This control 
P is a control character. All control characters are interpreted 
as requests to Emacs. Control characters are used to control 
Emacs, to manipulate the cursor and text. In this manual, the ~* 
symbol represents the control key; alphabetic characters 
following the “ symbol are represented as uppercase, even though, 
for them, a control character is the same whether the shift key 
is held down or not (and generally you would not hold it down). 


KSCAPE KEY 


The next key you should locate is the escape key. The 
escape key is commonly labelled with the letters ESC, ESCAPE, 
ALT, or ALTMODE. On some terminals, you may have to hold down 
the shift key to get an escape. Unlike the control key, which is 
held down while a normal character is typed, the escape key is 
typed sequentially, i.e., before or after a normal character. 
You use the escape key for some Emacs requests and to terminate 
your response to a few of the Emacs prompts. Be sure to release 
the ESC key quickly, to avoid getting two (or more) escapes in a 
row. In this manual, the letters ESC represent the escape key. 
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LINEFEED KEY 


Your keyboard should have a linefeed key labelled with the 
letters LINEFEED, LF, or NEW LINE. The linefeed key is sometimes 
used in Emacs. 


DELETE KEY 


The delete key transmits the ASCII DEL character, octal code 
17. The key is generally labelled with the letters DEL or 
RUBOUT. As its name suggests, its use is to rubout, or erase, 
the previously typed character(s). In this manual, the character 
sequence \177 represent the delete key. 


CARRIAGE RETURN KEY 


On Multics, a carriage return returns you to the left margin 
and inserts a newline character in your input. This key is often 
labelled either RETURN or CR. 


The Modem 


Your terminal must be connected to the Multics system in 
some manner for emacs, or any other Multics command, to work. 
The modem or an acoustic coupler provides an interface to the 
communications link between your terminal and Multics. Many 
modems are equipped with a telephone receiver and dial. For this 
type of modem, you dial a specific number to begin the logging in 
procedure and make the connection to Multics. However, a wide 
variety of modems exist; if you do not know how to establish the 
connection between your terminal and Multics, you should aska 
technically qualified person at your site to help you log in. 


Technical Requirements 


Two technical requirements that your terminal must meet are 
that it be an ASCII terminal, and that it be capable of running 
in full duplex mode (i.e., have controllable local echo). Bither 
your terminal or your modem may have a switch that can be 
positioned to half or full duplex mode; you should set this 
Switch to full duplex. If your terminal does not have 
controllable local echo (printer on/off), you should log in in 
full duplex and echoplex modes. Generally, your site will have 
arranged for appropriate terminal modes to be set automatically 
when you log in. If you find characters are printed out twice, 
setting the modes and/or switches should correct the problem. 
Again, if you have a question about either of these requirements, 
ask someone for help. 
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If your terminal has an auto-linefeed key or switch, be sure 
it is off, and use lfecho mode to achieve its effect. Failure to 
do this results in certain displays vanishing from the screen 
prematurely. 


LOGGING IN 


The first thing you want to do is establish a connection 
with the computer. This is called logging in. To log in, you 
must be registered on the system, as a member of a certain 
project. You are given a unique User id, user identification, 
which consists of a Person id (name) and Project id (project 
name). For example, Mary Smith, working in the sales department, 
may be given the following User id: 


Smith.Sales 


This User_id belongs to Mary alone; no one else can use it. Mary 
also has a password, which along with her User_id allows her to 
use the systen. 


The procedure for logging in is explained in depth in the 
New Users' Introduction — Part I. Briefly, however, to log in 
you turn power on for the terminal, dial the appropriate 
telephone number, and when you hear a beep Signal, either press a 
button or place the telephone receiver in the modem and wait. 
(This method is employed unless your terminal is directly 
connected to Multics, in which case you do not need to dial a 
phone number.) When a connection has been established, a header 
of the following type is displayed by Multics on the terminal: 


Multics 8.0: PCO, Phoenix, Az. 
Load = 26.0 out of 100.0 units: users = 26 


At this point, type the login command and your Person id, 
separated by a blank, and then a carriage return. For example: 


login Smith 
Password: 


Multics then requests your password (the second line, above). 
Depending on your terminal, the display of the password is either 
suppressed or hidden ina string of cover-up characters typed by 
the system. Video terminals usually just suppress tha password. 
If you make an error while logging in, the system informs you of 
it and asks you to try again. 
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| Login incorrect. | 
‘-* Please try again or type "help" for instructions. 
es | login Smith 


Password: 





After you have successfully typed your password, the system 
responds with information regarding your last login. 


Smith Sales logged in 06/07/80 0937.5 mst Tue from... 
Last login 06/06/80 1359.8 mst Mon from terminal... 


The last line of system-generated text in the log-in 
sequence is the ready message. This message is printed to 
indicate that Multics is at command level and ready to receive 
the next command. The ready message consists of the letter "r" 
followed by the time of day and two numbers that reflect system 
resource usage. For more information about the ready message, 
refer to the ready command in the MPM Commands. 


r 12:22 3.229 1799 


@€ The complete log-in sequence for Mary Smith is: 


login Smith 
Password: 


Smith Sales logged in 06/07/80 0937.5 mst Tue from... 
Last login 06/06/80 1359.8 mst Mon from terminal... 
r 12:22 3.229 1799 





P 
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INVOKING THE emacs COMMAND 


You have logged in and received the ready message indicating . 
that you are at command level. To enter Emacs, type the emacs 7. 
command on your keyboard, followed by a carriage return (Multics ‘ 
command lines are always terminated by a carriage return): 


emacs 


Depending upon the facilities available at your site, Emacs may 
or may not ask you: 


What type terminal do you have? 


It will ask this once per process (generally, per login session, 
if it asks at all, and you respond by typing in the name of the 
type of terminal that you are using. If you type an unacceptable 
name, Emacs displays the names of all terminals it knows how to 
support. Among these names, you should be able to find the 
acceptable form of the name of your terminal. Type it in, 
followed by a carriage return. 


If you cannot find your terminal listed, type: 
quit 


followed by a carriage return,to return to command level so that 
you can log out. You may want to try again on a different = 
terminal type. (Instructions for supporting new terminal types es 
are available in Emacs Extension Writers' Guide, Order No. CJ52, 
"Writing Emacs Terminal Control Modules.") 





The Initial Display 


Once Emacs has recognized your terminal type, either 
automatically oor by querying you as described above, it takes 
several seconds to get started. When it has started up, it 
clears the screen, and displays the line: 


Emacs (Fundamental) - main 


at the lower left of the screen. This line is called the mode 
line. It tells you several things, the most important of which 
is that you are talking to Multics Emacs, rather than to the 
command processor or to another editor. The name of the major 
mode you are inis parenthesized, and here it is Fundamental 














major mode. Emacs has several modes best suited for different 
tasks, such as preparing text or programs in the various 
programming languages. Major modes each have a distinct set of 
key bindings (typed key sequences that specify particular request 
instructions to Emacs). Minor modes provide "fine tuning" to 
modify the way the Emacs works, but do not have a special set of -_ 
key bindings. The names of minor modes, if you are using any, Te 
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appear right after the major mode name in the mode line, enclosed 
in angle brackets (<>). Fundamental mode is the simplest major 
mode. : 


You can edit several things at once with Emacs. Each 
separate thing being edited is edited in a separate "sub-—editor" 
called a buffer. The buffers are named so that you can 
differentiate between them. The buffer name of the buffer you 
start out in is "main". This is the last item displayed in the 
mode line above. 





The area between the top of the screen and the mode lines is 
where text appears, and where you deal with the text. This area 
of the screen is called the window. The window always displays 
about twenty consecutive lines of the document you are editing. 
Of course, if your document is shorter than that, part of the 
window is empty. 


At this point, the only sign of life in your window is a 
blinking object in the upper left corner. This is the cursor. 
It may be a blinking underline, or a blinking or solid box, 
depending on your terminal. The cursor is the most important 
object in Emacs. It is always on some position on the screen, 
and all "action" occurs at the cursor. All the text you enter is 
entered at the cursor (and the cursor moves), and all the text 
you delete is deleted at the cursor. 


) 


SUMMARY OF TERMS 

When the emacs command is invoked, the first screen 
displayed is pretty simple, since it is practically empty. You 
should, however, be familiar with the following terms, and be 
able to relate them to what appears on the screen. 

@ mode line 
major mode 
key bindings 
minor mode 
buffer 


buffer name 


window 


cursor 
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SECTION 3 


ENTERING TEXT AND SIMPLE CURSOR MOVEMENTS 


TYPING IN TEX? 


Now you are going to enter some text. To do so you simply? Modes” 
begin typing. Type the following on the terminal, and stop afters 2.5 
typing the period: 


This is sample text. 


In general, you may have to wait a few moments for the characters 
you are typing to appear on the screen, especially if it has been 
a few minutes since the last time you typed. If the user load on 
Muitics is especially heavy, the wait is correspondingly longer. 


eal The text appears at the top of the screen as you type. This 
line is the beginning of your document; the way it looks is 
exactly the way your document is. Stop and look at the screen. 
The cursor is to the right of the period in the sentence just 
typed. You should get into the habit of thinking of yourself as 
being "at" some point in your document. That point is indicated 
on the screen by the cursor. 


At the bottom of the screen, an asterisk (*) appears in the 
line below the mode line. This indicates that the buffer has 
been modified, i.e., changed in some way. It remains until the 
modified buffer is written out, and reappears thereafter whenever 
new modifications occur that have not been written out. This is 


discussed more in Section 5. 


Now add another line. Hit the carriage return key (for a 


Multics newline). This puts a carriage return into your text and 
moves the cursor to the beginning of the next line. Type: 


Here is more text yet. 


Again, the text appears on the screen as you type it. The first 
a . line you typed stays where it is, with the second line appearing 
So’ under it. Your document is now two lines long, and you could 
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continue to type in more text indefinitely. It is just like 
using a typewriter. . 


EDITING WITH EMACS REQUESTS 


macs performs all of its editing functions by carrying out 
programmed instructions when you issue a request. You issue, or 
invoke, a request by typing certain keys or key sequences. Each 
request (key or key sequence) is individually attached, or bound, 
to a command name, which tells Emacs what set of instructions to 
follow when you issue the request associated with it. <A command 
name is a hyphenated, abbreviated (sometimes) name that describes 
the action of the request to you, and specifies the appropriate 
instructions to Emacs. As you learn Emacs, command names serve 
to remind you of what the requests do. When you are proficient 
in Emacs, however, the command names can be used in computer 
programs to construct your own requests. As a matter of fact, 
you can "connect" (bind) any key of your choice to any command 
name of your choice if you do not like the default requests 
provided. The section on keyboard macros describes how to do so. 








Correcting Typing Errors with Emacs 


Even the best typist makes an occasional error. The 
following are special characters useful for making corrections 
with a single keystroke: 


@ # (The erase character) 
e \177 (the delete key) 
& @ (the kill character) 


To see how these characters work, you will have to type a 
line with an error in it. Go to the next line, by typing a 
carriage return, and type: 


Multix 


Stop as soon as you type the "x". 


THE ERASE CHARACTER (#) 


On Multics, if you type a wrong letter, you use the # (pound 
or number sign) character to erase it. The same is true in 
Emacs; the command name of the # request is rubout-char. Type 
the i character and watch what happens. The "x" in Multix 
disappears from the screen, leaving no trace of itself or the 
erase character. The cursor, which was positioned right after 
the x, backs up a Space and is now positioned right after "i" in 
Multi. No trace or record of the mistake remains. You could, at 
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this point, simply type in the letters c and s, and your 
correction would be completed. However, type an "x" back in, so 
that you can see another way to correct typing errors. 


THE DELETE KEY (\177) 


The screen should be set up now exactly the same as it was 
when you tried the erase character a minute ago. With the cursor 
right after the "x" in Multix, hit the delete key once. Again, 
the x disappears and the cursor moves back one space to appear 
right after the "i" in Multi. 


Typing either a # or a \177 erases the previous character, 
j.e., the character right before the cursor. The command name of 
the \177 request, as you might expect, is also rubout-char. 


THE KILL CHARACTER (@) 


Suppose that you decide you would like to erase the whole 
line, which now consists of the letters "Multi." The cursor is 
still positioned directly to the right of the trailing i. On 
Multies, you use the @ (commercial-at sign) character to erase 
everything typed so far on the current line. In Emacs, the @ 
also erases everything on the current line to the left of the 
cursor, and the remaining text moves to the beginning of the 
line. Try typing it. You see the five letters displayed 
disappear, and the cursor move to where the "M" was. The @ 
request's command name is kill-to-beginning-of-—line. 


MOVING THE CURSOR 


You could continue to add text to your two-line document by 
just typing it, ending lines with carriage returns whenever you 
want to go on to the next line, and correéting any mistakes you 
catch with the #, \1i77, and @. However, you would probably soon 
wish to change or modify some text already entered. In order to 
do so, you need to know how to move the cursor to the place 
requiring the change. The following paragraphs demonstrate how 
to move the cursor: 


@ to the previous line (“P) 
to the next line (“N) 


forward a character (“F) 


backward a character (*B) 


to the beginning of the line (*A) 


to the end of the line (“E) 
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Getting to the Right Line 
In order to change the line you entered that reads: 


"This is sample text" 
to 
"This is some sample text" 


you first have to get from the beginning of the empty third line 
on your screen to the first line, and then to the right place in 
that first line. To do this, you move the cursor up one line at 
a time by telling Emacs to go to the previous line. 


“ap 


The Emacs request that moves the cursor to the previous line 
is “P (control P). The command name is prev-line-command. 
Locate the control key, hold it down while you press the p key, 
and then release both keys. Now watch the screen: you see the 
cursor move up to the previous line, to a place right above where 
it had been. Note also that when you type the “P,- you do not 
"see" it appear on the screen, but only its effect. What you see 
on the screen is what you have in your document, and it does not 
matter what you used to achieve that state. 


You still need to go up one more line, so type another “P. 
Moving Within the Line 


“FB 


Now that you are on the line in which the change is to be 
made, you need to be able to move the cursor forward to the 
correct point on that line. The Emacs request for moving forward 
a character at a time is “F, forward-char. Hold down the control 
key and slowly press the f key afew times. The cursor moves to 
the right, one character at a time, as many times as you type “F. 
Continue to type “Fs until the cursor is under (or covering, on 
some canine) the letter s of the word "sample". This is where 
you plan to add the word "some". 


“B 


If you go too far to the right, you have to "back up" to the 
sin "sample". The Emacs request for moving backward a character 
at a time is “B, backward-char. So, regardless of whether you 
did in fact go too far or not, try moving the cursor backward. 
Again, hold down the control key and hit the b key several times. 
The cursor moves backward to the left one position for each “B 
you type. Soon you reach the beginning of the line. You cannot 
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go any further back, since this is the beginning of your text, so 
Emacs causes your terminal to beep, indicating that you have made 
an error. Simply wait for the beeping to stop, and release the 
control key. 


Now, go ahead and move the cursor forward again to the s in 
"sample". To add the word "some", just type it in. Emacs moves 
the rest of the line over and displays your text: 


This is somesample text. 


Obviously, this is not quite the way you want this sentence to 


appear. To add the space between the two words, simply hit the 
space bar. Now you see: 


This is some sample text. 


with the cursor still under the s in "sample". The text is 
fixed. 


Note that you did not have to do anything special to type in 
the new word. You just moved the cursor to the right place and 
Started typing. 


Getting Back to the Right Line 
“N 


In order to add afew more lines to the end of your 
document, you must move the cursor down a couple of lines. You 
do this by going to the next line, and then the next line after 
that. As you may have guessed, the Emacs request for going to 
the next line is “N, next-line-command. Hold down the control 
key and type anon. The cursor moves down to the next line, but 
note its position in that line. Emacs tries to keep you in the 
Same column when going between lines, so the cursor is under the 
initial tin the word "text". When you hit the n key again, 
still holding down the control key, the cursor moves down another 
line but goes all the way over to the left. This line is empty. 
Although Emacs tries to keep you in the same column, it chooses 
the column ina reasonable fashion. In general, you would not 
consider it useful to be positioned in the middle of an empty 
line. Likewise, if the word "Multix" had still been on this 
line, Emacs would have placed the cursor immediately to the right 
of the x, the closest column on this much shorter line. 
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“A 
To try out the next two line-movement requests, type in: 
using Emacs is easy 

To say instead, "I think using Emacs is easy," you could type a 


string of “Bs to move backwards to add the first two words. 
However, an easier way exists (using Emacs really is easy). 
Emacs provides the “A request (go-to~-beginning-of-line) to move 
the cursor to the beginning of the current line. Type a “A and 
watch your screen. The cursor moves to the u in "using". You 
can now type: 


I think 


remembering to end with a space so that the "Somesample" problem 
does not recur. 


“E 


The only thing now missing from your sentence is 
punctuation. Rather than typing a series of “Fs to move forward 
a character at atime, you can skip right to the end of the 
current line with a “E, go-to-end-of-line. The “E request 
positions the cursor right after the last character, and before 
the carriage return if the line has one. On a line with nothing 
on it (nothing in it but a carriage return), “E does nothing. 
Try the “E, watch the screen, and then type either a period or an 
exclamation point, depending on your state of enthusiasm! 


GETTING STOPPED 


You may wish to practice and experiment with the Emacs 
requests you have just learned. Feel free to do so, since none 
of this text will be saved (reading in and writing out files is 
covered in Section 5). If you have wondered how to actually 
insert one of the special characters, like the #, into your 
experimental text, here is an additional thing to try out. When 
you are finished you can exit from Emacs and log out of Multics. 


“Q 


The ™@) request, quote-char, "quotes" the character 
immediately following it, i.e., it tetls Emacs to insert it 
literally into the buffer. For example, if you hold the control 
key down and type aq, then release the control key and type a 
pound sign (holding down the shift key on your terminal if 
necessary), a # appears in your text. No characters are deleted. 
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Exiting from the Editor 


_ When you began this session, you logged into the Multics 
( } system. You were then at command level, and, therefore, able to 
. invoke the Multics command, emacs, to enter Emacs. When you want 
to leave Emacs, you must return to command level by issuing an 
Hmacs request. Once returned to command level, you can invoke 
the Multics logout command, andend the session. Figure 4-1 
illustrates this process; an imaginary "you are here" arrow would 
point to the lower Emacs box. 








Multics 
Command level 





emacs ie ae © 
CC Kmacs 


Figure 3-1. Editor Entry and Exit 


The Emacs request that returns you to command level is “X°C, 
quit-the-editor. The control key must be held down while you 
depress first the x and then the c keys. Try it. As you watch 
the screen, the top several lines of your text is replaced by the 
following message from Emacs: 


Modified Buffers: 
> * main 


Pipe 
g aX 
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At the same time, Emacs writes a message and question, called a 
prompt, in the area below your mode line at the bottom of the 
screen (the prompt is called that because Emacs is "prompting" 


you for a response). This area where the prompt appears is 
called a minibuffer, and normally occupies two lines (though both 
are not always used). Hmacs prints this message in the 
minibuffer: 


Modified buffers exist. Quit? 


Since your buffer has changed, from being empty to having text in 
it, it is now modified. Emacs is telling you that you have done 
work that will not be saved, and doublechecking to be sure you 
really want to quit under these circumstances. If you had saved 
your work by writing it out to a file, Emacs would not prompt you 
at all, but simply return you immediately to command level. 


However, Since you are not going to save this practice work, 
simply type your response: 


yes 


and a carriage return. Prompts require not only a response, but 
also atermination character, generally a carriage return, to 
indicate the response's end. When you type the carriage return, 
angle brackets (<>) appear in the minibuffer at the end of your 
response. Emacs clears the screen and returns you to Multics 
command level. A ready message appears at the top of your screen 
to indicate that you are, indeed, at command level. 


Just in case you mistype "yes", you should know that Emacs 
will indicate an inappropriate response to its query. At the top 
of the screen, the line that said "Modified Buffers:" will say 
instead: 


Please answer "yes " or "no" 
This not only lets you know you have given the wrong response, 
but also provides you with the acceptable choices, either of 
which you can now type. If you catch the error before typing a 


carriage return to end the prompt, you can edit your response 
just as you would edit text. 
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SUMMARY OF TERMS 


A few new terms have been introduced that you should 


& remember, since they are going to be mentioned frequently. 
request 

& command name 

@ prompt 

® minibuffer 

e modified buffer 
Logging Out 

From command level, you can now invoke the Multics command 
for logging out, logout. Logging out breaks the connection 
between your terminal and Multics. After you have typed it, the 


system responds by displaying your identification, the date and 
time of the log out, and the total CPU time and memory units 
used. 


Logout 
fro Smith Sales logged out 06/07/80 1249.4 mst Tue 
{Cc CPU usage 17 sec, memory usage 103.1 units. 


hangup 





The word "hangup" is displayed by Multics to remind you to hang 
up the telephone and to indicate that the connection has been 
broken on purpose. 
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SECTION 4 


SIMPLE DELETING AND KILLING 


DELETING CHARACTERS 


You already know how to use the # to delete mistyped 
characters. This is especially useful if you catch an error 
immediately after typing it, since it erases the single character 
to the left of the cursor. To learn another method, log in again 
and invoke the emacs command. You can now type in the following 
text, exactly as it appears here so that you: can follow this 
lesson easily (do not type a carriage return after 
"computerized."): 


There's no denying that computer technology has made 
our lives easier. Computers serve us at home and at 
our jobs. In publications wirk, three areas made much 


faster by automation include text entry, editing, and 
formatting. Someday even typesetting will be computerized. 





The cursor should now be to the right of the period following 
"computerized". In reviewing this text, you see that in the 
third line, “wirk" should actually say "work". To correct this 
in Emacs, first you have to "go" to that point, by moving the 
cursor. Type two “Ps, the previous line request, and your cursor 
moves to after the "h" in "much". The backward character 
request, “B, gets you to the letter "i" in the offending "wirk". 
Since you have to move backward several characters, you should 
hold down the control key and hit the b a dozen or so times. If 
you go too far, use “F to go forward to the correct spot. The 
cursor should end up under oe covering) the "i" like this (the 
cursor is represented as an underscore): 


our jobs. In publications wirk, three areas made much 
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You now want to change the i at the cursor to ano. In 
Emacs, this change is made by deleting the unwanted character(s), 
and typing in the desired one(s). You delete characters, one 
character at a time, by typing “D, delete-char. Type one “D and 
watch the screen. The third line now appears as: 


our jobs. In publications wrk, three areas made much 


The "i" has been removed from the line, the text has closed up, 
and the cursor is under the "r". Now type the correct letter, 
and the line reads: 


our jobs. In publications work, three areas made much 


The cursor is again under "r" that follows the "o" that you 
added. 


Deleting Lines 
“K 


Often, you need to delete a lot more than a few characters; 
you want to remove entire lines, large pieces of lines, or many 
lines. The kill lines request, “°K (kill-lines), does this. For 
example, typesetting already is computerized, so you might want 
to replace that sentence with something else. Again, you must 
reposition the cursor and then correct the text. 


First, get to the-letter "S" in "Someday" by using the 
backward character, forward character, next line, and previous 
line (“*F, “B, “N, *“P) requests. When the cursor is under the "S" 
type a “K, and watch the screen. All the text between the cursor 
and the end of the line vanishes. 


RETRIEVING KILLED LINES 


You could replace the line just killed by typing in a new 
sentence right here and now, but suppose you decide instead that 
you really want it back. (The terms "delete" and "kill" both 
mean to erase text, but generally delete applies to characters 
deleted one at a time, and kill applies to characters deleted as 
groups, i.e., lines and sentences. You can get it back intact 
because it has been preserved in a special place called the kill 


ring. 
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The Kill Ring 


The “K request puts killed text in the kill ring, and it 
stays there so that you can retrieve it, either right away or 
many requests later. Often it is useful to purposely kill text 
so that you can move it from one place to another by killing it 
at one position in your text, repositioning the cursor, and then 
retrieving it from the kill ring. Whether you purposely or 
accidentally kill text, however, the kill ring provides the 
security of being able to conveniently recover it. 


The kill ring has ten "slots" for saving your text. When 
you issue a kill request (you know only two so far, @ and *X), 
the killed text goes into the first slot. (The # and “D requests 
do not put the characters they delete into the kill ring. If you 
accidentally delete a character, it is easy enough to retype it; 
if you delete many characters by hand, it is probably not a 
mistake and thus not important to be able to recover them.) If 
you later issue another kill request, the text previously killed 
moves into the second slot, and the newly killed text goes into 
the first slot just vacated. Killed text keeps rotating down a 
Slot in this fashion until all ten slots are filled. At the next 
kill request, the very first killed text would be discarded, 


Since no eleventh slot is available in which to save a ey eee 
a a - ‘ . i x 4 
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Kill merging is a feature that allows you to save related ~ 


killed text in the same slot in the kill ring. For example, if 
you are looking at several lines, and decide to kill them, you 
probably start at the top and delete them line by line. Since 
you delete them as one, they should be stored as one, so that 
they can be brought back as one. Kill merging provides this; if 
you type successive kill requests that kill text in the same 








direction, the text killed by each request is merged and occupies 


only one slot. 


So, for kill merging, the kill requests must be: 
& successive kill requests 
@ in the same direction 


Successive kill requests have no intervening keystrokes between 
them; you cannot type in any new text or issue any non-kill Emacs 
requests. If you do, the killed text goes into separate slots. 
These successive kill requests must also kill text in the same 
direction in order to merge, i.e., the requests must both/all 
eliminate text from either right to left (forward), or left to 
right (backward). The *“K kills forward. The @ kills backward 
(however, note that you cannot do successive @ kills, so they 
would never merge anyway). 
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SUMMARY OF TERMS 


Before moving on to see how killed text actually is 


retrieved, you should be sure to understand the terms dealing 


with where it is retrieved from: 
e kill ring 
@ kill merging 


® successive kills 


Yanking Text Back 


While you have been reading the above, the "Someday even 
typesetting..." sentence has been sitting in the kill ring. 
Maybe you want to reconsider using it, and would like another 
look. 


aa 


You can "yank" it back out of the kill ring by typing a “Y. 
The “Y request, named yank, is useful for letting you fix damage 
done by mistaken or inadvertent killing, and for moving lines 
around. Type a “Y and watch the screen. The sentence is back, 
and the cursor is positioned after it. 


Reposition the cursor, by means of the requests you know, to 
the "S" in "Someday". Remove the sentence again with “K and type 
in: 


Speed is essential, since technological 
advances must be documented to be used. 


The correction is made, and this new sentence begins where the 
killed one began. 


MORE ABOUT “K 


The “K request does different things depending on whether it 
is used at the end of a line or not. Type about four “Ns to get 
to a fresh place on the screen to enter some new text. Note that 
the cursor is at the left margin; these lines are empty. Type 
the following well-known verse: 


I wandered lonely as a cloud 


That floats on high o'er vales and hills, 
When all at once I saw a crowd, 


A host, of golden daffodils; 
Beside the lake, beneath the trees, 
Fluttering and dancing in the breeze. 





Position the cursor to under the "I" starting the verse. 
Now kill all the text on that line with a “XK. Observe the 
screen: the line becomes blank. Now type “K again (a successive 
forward kill), and watch the screen. All the-:rest of the poem 
moves up. To summarize the actions of “kK: 


@ When anywhere but at the end of a line (i.e., at the 
beginning or in the middle of a line), “*K deletes all 
text between the cursor andthe end of the line, 
leaving the cursor at what is now the end of the line. 


®@ When at the end of aline, “K removes the carriage 
return, or "sticks the next line onto the end of this 
one," making one line. If the line that the cursor is 
on has nothing in it (except the carriage return), this 
makes the line go away. If the line that the cursor is 
on contains more than a carriage return, the next line 
is tacked onto the end, as though you never hit a 
carriage return between them. 


Now type another “K. The line: 


That floats on high o'er vales and hills, 


empties out. Type it once more, and that (now empty) line 
disappears, and the cursor is at the beginning of the next line 
of the poem. Typing successive “Ks deletes lines one by one as 


you type them. 


To yank these lines back, type one “Y. Both lines come back 
because the text was merged in the first slot on the kill ring. 
Try typing another “Y, and watch the screen. If you were 
expecting to get the "Someday even typesetting..." sentence 
yanked back, you will be surprised to see the two poetry lines be 
duplicated on your screen. dust because they have been yanked 
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back once does not mean they are no longer in the kill ring. In 
fact, they still occupy the first slot, and you can yank them 
back into your text anywhere as many times as you want, as long 
as they remain in the kill ring. The “Y yanks text from the 
first slot. When text is pushed into succeeding slots by 
Subsequent kills, it is retrieved by giving a numeric argument to 
the Y request (essentially, providing the number of the slot 
from which text should be yanked). Numeric arguments are 
explained in Section 8. 


One additional note: sometimes more text gets yanked back 
than you actually want. However, going back and killing any 
unwanted text that you have yanked is much easier than having to 
retype killed text that you could not yank. 
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SECTION 5 
WRITING AND READING FILES 
This section explains how to save your edited text by 
writing it out to a file, and how to read existing files into 


Emacs for editing (files and the Multics storage system are 
explained in detail in the New Users' Introduction - Part I). 


WRITING A FILE QUT 





Before you write the contents of the "main" buffer out to a 
file, put about twenty more lines into it. Just type in 
additional short lines of any text you choose. The object is to 
have enough text to experiment with while learning the remaining 

C3 Emacs requests. Be sure, however, to embed these lines somewhere 
(in what you add: 


Now is the time, and the only time, 

for those who have the time to 

give their time. 
ag “W 

The Emacs request for writing a file is “X°W, write-file. 
When you finish adding text, type “X°W and watch the screen. 
Emacs prompts in the minibuffer: 


Write File: 


The cursor has jumped from the last character you typed into the 
minibuffer, and is waiting for you to supply the pathname of the 


place you want to write the buffer's contents. Type ina 
pathname, and end the prompt with the carriage return. For 
example: 


first.practice 


This creates a segment named first.practice in your working 


( directory. As Emacs writes this file, the word "Writing..." 
“appears in the minibuffer. When the word "Written." replaces 
\- "Writing...," you know that the file has been successfully 
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written out to the Multics storage system. At the same time, the 
full pathname of the file appears right below the mode line. 
This is called the path line, and tells you exactly what file you 
are working with. Tou are, in fact, only working with a copy of 
the file; any additional changes you make would not be reflected 
in first.practice until you write it out again.) You may have 
noted the asterisk (*) that began the path line. It appears 
there whenever a modified buffer has not yet been written out. 
Hence, when you issued the “X“W, it disappeared. It reappears 
with subsequent modifications, remaining until the next writing 
out of the buffer. It is a convenient indicator for determining 
whether or not you need to write out the buffer in order to save 
your work. 





The bottom of your screen now looks something line this: 


Emacs (Fundamental) - main 
>udd>Sales>Smith>first.practice 


Write File: first.practice<> 
Written. 





You have the mode line and the path line, followed by the two 
lines in the minibuffer that provide extra "status" information. 


Is Your New File Really There?’ 

To verify that you have indeed written out a segment called 
first.practice, leave Emacs and return to command level. The 
“x*C request does this. Now you can invoke the Multics list 
command, which lists the segments (in your working directory in 
this case). (The list command is described in detail in the New 
Users' Introduction - Part I.) Type: 

list 


The segment named first.practice should be the first file listed. 


READING A FILE I 


When your files have been listed, and you have a ready 
message, reenter Emacs by invoking the emacs command: 


emacs 


You can now read in a file. 


When you read ina file, it is read into a buffer; every 
file read in goes into its own buffer. The first twenty or so 
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lines appear on the screen. Although you see only these first 
several lines, the whole file is there. If you try to position 
the cursor to an unseen line, either by doing “Ns so that the 
cursor tries to go off the bottom, or “Ps so that the cursor 
tries to go off the top, Emacs displays the lines so that the one 
you want is indeed shown. 


“XR 
The find file request for reading in files is “*X"F, 


find-file. Type it and watch the screen. The cursor drops below 
the mode line, into the minibuffer, which reads: 





Find File: 


with the cursor after the colon. Kmacs is prompting you for the 
pathname of the file to be read in. 


Type the pathname of the file that you previously wrote out, 
ending with a carriage return. In our example, you would type 
either: 


>udd>Sales>sSmith>first.practice 


or, if you are in the directory that contains first.practice, 
Simply: 


first.practice 


If you make a mistake while typing in the minibuffer, you can 
edit it with #, “B, “D, “F, or any other request, before you type 
the carriage return. Assuming you have typed it correctly, Emacs 
prints "Reading..." in the minibuffer, and strikes it out when 
it has finished reading. The screen fills up with the first 
windowful of the file. The cursor is at the first character of 
the first line. 


Now look at the mode line. The buffer is no longer "main," 
but "first." The buffer name is taken from the first component 
of the entry name of the file read in (in this case, the file was 
first.practice, so the buffer is named "first"). The path line, 
below the mode line, gives the full pathname of the file in this 
buffer. 


Once a file is read in, you may want to know how big it is. 
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The line counter request tells you how many lines are in 
your document, the number of the line in which the cursor is 
currently positioned, and the cursor's dprint column position. 
This request is “X=, linecounter. 


Type a “X and an equal sign (=). Be sure to release the 
control key before striking the equal sign. Also, remember to 
hold the shift key down if the equal sign requires a shift on 
your terminal. 


Emacs prints something similar to this in the minibuffer: 
38 lines, current = | 


This sample document is 38 lines long, and the cursor is on the 
first line. 


Now type “Ns slowly until the cursor is on the line right 
above the minibuffer. Be careful, just this time, to type slowly 
enough so that the cursor stays in the window currently 
displayed. Now note the contents of the line it is on. Then 
strike one more “N. Emacs rewrites many lines on your screen, 
and, if your terminal has the capability to do so, moves many 
lines around. When it is finished, the cursor is on a line in 
the middle of your screen. Look at the line above that one. You 
see that it is the same line that was at the bottom of the screen 
a minute ago. 


Type another “X=. The minibuffer now says something like 
this: 


48 lines, current = 22 


If you look at the screen, the cursor is on about the twelfth 
line, not the 22nd. However, you are editing the file (or the 
buffer), not the screen. The line you are on is, in fact, the 
22nd line of the buffer. Since only about 21 lines can be 
displayed at once, Emacs automatically chooses which 21 lines to 
display in order to make sure that the line you want is on the 
screen. 


You can now edit this file as though you had typed it in, 
using all the requests you know. Try putting in a new word or 
killing a line. At once, the word: 

Modified 


appears in the minibuffer, letting you know that you have changed 
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the file since you read or wrote it, and have to write it out if 
you want your work to be saved. 


SAVING (REWRITING) A FILE 


Having made some editing changes to the file, you must write 
it out to save them. 


“xX*S 


The request that writes out the same file that you read in 
is “X"S, save-same-file. This request uses the default pathname 
of the file when writing out the buffer's contents. This means 
that when you type a “X°S, Emacs recognizes that you wish to use 


a pathname that it already knows. Essentially, you are telling 
Emacs, "Since no pathname is supplied here, you should, by 
default, use one already supplied." The default pathname is 


always the pathname that appears in the path line. The “X°F 
request sets the default pathname, and typing “X*S causes Emacs 


to "go get" that pathname and write the buffer out to the segment 
named therein. | 


Try typing “X°S. You notice that Emacs does not prompt for 
a pathname, but does repeat the "Writing.../Written." message in 
the minibuffer to let you know when it is done. 


ADDITIONAL NOTES ON WRITING FILES 


— SSE eee Oe 


Access Restrictions 


You may encounter a problem sometimes when you try to write 
out a file that you have read in without any trouble. This 
occurs if you have read (r) access to the file, but do not have 
write (w) access (access requirements are discussed in the New 
Users' Introduction —- Part I). You will be notified that you 
have an access problem by an error message like this: 


Incorrect access on entry. 


If Emacs displays such a message, you cannot use “X°S; you must 
write out the file with *“X*°W and supply a different pathname from 
the one used to read in the file. 


The Default Pathname with “X“W 


—_—S——_—_—_—— i ———— Ee 


When. writing out a file with “X°W, Emacs prompts you for a 
pathname. If you wish to write the file out to the default 
pathname set by “X°F, simply type a carriage return in response 
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to the prompt. The “X“S request performs the 
is, of course, slightly more convenient. 


SUMMARY OF TERMS 


Same action, and 


Two new terms introduced above that you need to remember 


are: 
® path line 


e default pathname 
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SECTION 6 


LOCATING A SEQUENCE OF CHARACTERS 


A fundamental ability needed in editing is that of looking 
for a particular sequence of characters, or searching. In Emacs, 
this means finding a given sequence of characters in the buffer, 
and moving the cursor to that point. 


To try out these next requests, you should start at the 
beginning of your file. Use “Ps to get there. 


SEARCHING FORWARD 


When you search forward, Emacs starts where the cursor is 
and searches toward the end of the buffer. 


“Ss 

The string search request is “S, string-search. To locate 
the first occurrence of the word "time," type a “S. Emacs 
responds in the minibuffer: 

String Search: 
The response to this prompt is to type in the string to search 


for, in this case, the letters t, i m, and e. Then type a 
carriage return. Almost all prompts in Multics Emacs, including 


those for search strings, end with CR. When you type the CR, you 


a 


see the cursor return to the main window, but it is now 
immediately after the e in the first occurrence of the word 


"time." 
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Try looking now for the word "grime." Type a “S, type the 
letters g, r, i, m, and e, and hit the CR key. Emacs responds: 


Search fails. 


in the minibuffer, since no "grime" was found between the 
cursor's position at the end of "time" and the end of the buffer. 
The cursor remains where it was. 


Try locating "time" again as you did before. The cursor 
advances to the right of the next "time" in the buffer. The “*S 
only searches forward, never backward. [It puts-the cursor after 
the end of the string it finds so that Emacs will not keep 
finding the same one, 


You can take a shortcut in locating the third "time." Type a 
“S, but when Emacs prompts for the string, simply hit the CR key. 
Emacs puts the word "time" in the minibuffer just as though you 
had typed it. When you answer a search request's prompt with an 
"empty" search string, i.e., a CR only, Emacs reuses the last 
search string (sequence of characters) you were searching for. 
This use of a default search string applies to all the search 
requests. This way, you can search for the same thing many times 
without retyping it into the minibuffer. Search for "time" a 
couple more times, just so you will be positioned after the 
embedded sentence. 


GETTING OUT OF TROUBLE 


“G 


An important Emacs request lets you “get out" of what you 
are doing. This is the “G, command-quit. Try typing it; your 
terminal beeps. The “G does more than just beep, however. Type 
another “S, and Emacs again prompts: 


String Search: 


Suppose you decide that you did not want to search for anything, 
or you typed “S in error. Simply type “G; the cursor exits from 
the minibuffer, the terminal beeps, and the search request is 
aborted. This request can always be used to exit the minibuffer 
to abort any prompting request, such as “X°F or “X°W, that you 
change your mind about in midstream. If you ever find yourself 
in the minibuffer with a prompt that you do not understand, or 
think you did not ask for, typing “G will get you out without 
doing any harm. 
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The fact that “G causes a beep can also be used to let you 
know when Emacs has "caught up" to you after a large number of 
cursor movement requests. When you type a “G at the end, you 
know that the beep means that Emacs is responding to the last 


request, so the others are done. This is sometimes useful when 
the system is slow. 


“XG. “72°C. AND ESC 7G 


The “X°G, “Z°G, and ESC “G requests are similar to “G. When 
you type a prefix character, i.e., “X, “Z, or an ESC, by mistake, 
these requests undo it, i.e., they flush the prefix character. 
So, if you type *“X, *Z, or ESC in error, just go on to type “G 
right after them to get out of it. All three requests also cause 
the terminal to beep. However, unlike “G, they do not exit the 
minibuffer. These requests are all named ignore-prefix. 


SEARCHING BACKWARD 


“R 


To search ina backward, or reverse direction, type “R 
(reverse-string-search). Emacs prompts in the minibuffer: 


Reverse String Search: 


Search for the word "time" again; since that was the same string 
used in your last search request, you need type only a CR in 
response to the prompt. The string "time" appears in the 
minibuffer, and the cursor is left before (i.e., under the first 
character of) the first occurrence of "time" going backward from 
where the cursor was when you typed “R. If the cursor was right 
after a "time," it is now right at the front of the same one. 


Repeat the process. The cursor goes one "time" back each 
time, until there are no more between the cursor and the 
beginning of the buffer. Emacs then responds: 


Search fails. 


in the minibuffer. 
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GENERAL RULES FOR SEARCHING 


The “S and “R requests both: 


@ prompt in the minibuffer 


® take a string terminated by CR to use for a search 
target 


@ use an empty string (just aCR) to indicate that the 
last search string used should be used again. 


The reverse string search (*R) goes: 
€ backward to the beginning of the buffer 


@ leaves the cursor before the located string 


The string search (*S) goes: 
a) forward from the beginning of the buffer to the end 


& leaves the cursor after the located string. 


When searching for something in Emacs, you generally know if 
you want to search forward or backward for it. If you do not 
know, search forward. If the search fails, just type a “R and a 
CR, and Emacs’ searches backward for the same string. If the 
search fails again, the string is not in the buffer. 


LOCATING AND REPLACING STRINGS AUTOMATICALLY 


ESC % 


A powerful request that allows you to search forward for a 
specified string, and replace that string with another, is ESC 4%, 
query-replace. After you type and release the escape key, type 
the % character, and you are prompted for the string to search 
for and the replacement string. Type both in the minibuffer 
(they are individually prompted for), and end both prompts with 
CRs This request locates, by searching forward, the first 
string, positions the cursor immediately after the string, and 
pee for one of the following responses (type the appropriate 
keys): 


space 
replaces this occurrence of the first string with the 
second. Then searches for the next occurrence of the 
first string and waits for a response again. 
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CR 
leaves this occurrence of the first string unchanged 
tps, and searches for the next occurrence of the first 


ae: String, again waiting for a response after locating 
2 Gs 


(period) 


replaces this occurrence of the first string with the 
second and then terminates the query replace. 


leaves this occurrence of the first string unchanged 
and terminates the query replace. 


This request allows you to substitute one string for another 


selectively throughout your buffer. Try replacing some of the 
oceurrences of "time" with "grime." 


yon. 
i 
( a r 

% ” 
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SECTION 7 


WORKING WITH BLOCKS OF TEXT 


MARKING A REGION 


Often you wish to delete an arbitrary extent of text, i.e., 
from "here to there," without the tedium of carefully killing 
individual lines or characters. This extent, or block of text, 
is called a region in Emacs. In order to delete a whole region, 
you first must be able to define its limits, or boundaries. 


setting the Mark 


One limit of the region to be deleted is determined by the 
position of the point at the time the region-deleting request is 
given. The cursor, on most terminals, is under or overa 
character. Its left edge, however, can be described as being 
always BETWEEN two characters, the character at the cursor and 
the character preceding that one. The point is this position 
between the characters, indicated by the left edge of the cursor. 


A further distinction between the cursor and the point is 
rather fine. However, the point is the theoretical location of 
the cursor's left edge at a specific time, or where it would be 
if it had gotten there by the time Emacs ‘takes action as though 
it had already. The cursor itself is often a moving object; its 


actual location at a specific time may be somewhere between where 


it was and where it was going to be when Emacs interrupts its 
journey to send it somewhere else. Emacs knows where it was 
going to be, however, and that is the point! Figure 7-1 
graphically illustrates the difference between the cursor and the 
point. 
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Cursor and point User types “P°P*P°D. Cursor and point 
between Ds. Point between A and A. at top line 
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Figure 7-1. The Cursor and The Point 


So, one of the region's limits is the point. The other 
limit is specified by an "invisible cursor" called the mark. 
Kach buffer has only one current mark, and has none at all until 
you set it. However, whenever you reset the mark (i.e., set it 
in a new position), the old value of the mark is saved on a mark 
ring that works like the kill ring. Section 8 describes how to 
retrieve these "saved" marks. You cannot delete a region until 
both limits define its boundaries. 7 





“@ 


To set the mark, you first must move the cursor to where you 
want the mark to be. You are going to delete this portion of the 
Wordsworth poem: 


Beside the lake, beneath the trees, 
Fluttering and 


Move the cursor to under the B in "Beside." set the mark there 
(i.e., at the oint in front of this "B') by typing “@, 
(set-or—pop-the-mark) . This may be tricky if your terminal 


requires a shift to get the commercial at sign, since you will 
have to hold down both the control and shift key while you hit @. 
On some terminals, e.g., Digital Equipment Corporation terminals, 
you have to type the space bar while holding down the control key 
to send the “@ character. The word "Set" appears in the 
minibuffer to let you know the mark is set. 
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Now move the cursor to the space between "and" and "dancing" 
in the next line, i.e., right after the last letter of the last 
word to be deleted. This is the point, and your region is 
defined by the two limits. 


re 


Before deleting a region, you often want to verify that you 
do indeed know where the mark is. By exchanging them, i.e., 
Switching the cursor and the mark's positions, you can do this at 
a glance. 


“X°X 


The “X*X request, exchange-point-and-mark, makes this 
exchange. Try it. The cursor suddenly appears under the B in 
"Beside." Type another “X°X and everything is as before. 


DELETING A REGION 


“W 


You are now ready to "wipe" out, or delete, the marked 
region. Type “W (wipe-region). All the text between the mark 
and the point disappears from the screen. The newline character 
within the region also is gone, so you end up with: 


A host of golden daffodils; 
dancing in the breeze. 


You still have a space before "dancing;" this is because the 
Space was not included in the region to be deleted. 


Yanking a Region Back 


The “W request, like the “K request, puts whatever it 
removes into the kill ring. Type a “Y and watch the text 
reappear. A useful feature of the “Y request is that it 
automatically sets the mark (or resets it if it was previously 
set) at the beginning of the text it retrieves, and leaves the 
cursor after it. This has two implications that should be noted: 





® After yanking text with “Y, for any reason, you can 
delete it again simply by typing “W, since the cursor 
and the mark exactly specify the limits of what was 
yanked. 


® After yanking text with “Y, for any reason, you can 


move the cursor to the beginning of the yanked text by 
exchanging the point and the mark with “X°X. 
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Your cursor, now in the middle of the last line of poetry, 
can go to the B in "Beside" if you type “X°X. Try it. Now, even 
though the cursor is at the beginning, and the mark at the end of 
this region, try typing “W. The region disappears. As long as a 
region has both limits set, “W works whether the point or the 
mark is the first limit. 


ESC Y 


Sometimes you kill some text, move the cursor, kill more 
text, and then decide that killing that first text was a mistake. 
What you want to do in this case is return to where you killed 
that first text and yank it back. ‘So you move the cursor back 
and type “Y. Unfortunately, that retrieves the text of the 
second kill; the most recently deleted text occupies the first 
slot on the kill ring. So now you want to get rid of the 
retrieved text and retrieve the text of the previous kill. 


Well, ESC Y, wipe-this-and-yank-previous, does this. It 
deletes and discards the text just yanked, thus freeing the first 
slot on the kill ring so that text from the previous kills moves 
up a Slot, and then it retrieves the text now in the first slot. 
Try a couple more “Ws, and then ESC Y (hit and release the escape 
key before typing a y). By doing many ESC Ys in a row, until you 
"find the kill that you want," you can "go shopping" in the kill 
ring for saved text. Just bear in mind that this type of 
shopping can "leave the store sold out." 


SUMMARY OF TERMS 


Many Emacs requests besides “W use regions. You should, 
therefore, understand the following terms: 


S region 
@ point 
® mark 
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SECTION 8 


REPEATING REQUESTS 


Emacs provides a variety of ways for repeating the action of 
a request, either once or many times. Requests for which it is 
meaningful and useful to specify "how many times" to do them 
generally accept a numeric argument. A numeric) argument is 
essentially a repetition count, a number that means "repeat this 
action this number of times." Positive numeric argument 
generally repeat the request's action in a straightforward 
manner. Negative numeric arguments generally reverse the action 
of the request and repeat it; 1.e., tney cause a request to act 
like its complement, if it has one. 


NUMERIC ARGUMENTS 


If you want to say, "Go five characters forward," or, "Go 
four next lines down," you can give the “F and. “N request 
positive numeric arguments of 5 and 4, respectively. 


You givé a numeric argument by typing the escape key, ESC, 
then typing the number you want, and, finally, typing the 
request. For example, to delete six characters, you would type; 


ESC 6 “D 


(spaces are unnecessary and incorrect, but have been included for 
legibility.) That is, strike and release the escape key, type a 
6, and then type a “D. All the characters disappear at once. 
Try it. 


Similarly, if you type: 

ESC 249 °N 
while on the first line of a large file, the screen would fill 
immediately with lines 240 to 260 (approximately) of the file, 
with line 250 and the cursor in the middle of the screen (you can 


verify the line number with “X=). You do not have to watch the 
cursor step through 250 lines one by one. Experiment with your 
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file and the “N and “P requests. Deliberately give a numeric 
argument too large for your file, and observe what happens. 


A negative numeric argument is given by typing ESC -N, where 
N is the number, before typing the request. With negative 
arguments, “F goes backward the specified number of characters, 
“N goes to the Nth previous line, *D acts like # or \177 and 
deletes N characters to the left of the cursor, ete. An argument 
of ESC -1 or, simply, ESC-, just reverses the action and performs 
it once. Some requests do not accept negative arguments; you 
receive a message in the minibuffer stating this if you give them 
one by mistake. 


Requests Accepting Numeric Arguments 


Of the requests already learned, the following accept 
numeric arguments. 


Forward Character 
Backward Character 
Next Line 

Previous Line 
Rubout Character 
Rubout Character 
Delete Character 


Kill Lines 
Yank 
Set/Pop the mark 





The first seven, when given either a positive or negative numeric 
argument, perform the action that number of times. The last 
three act in a special manner, and do not accept negative 
arguments. 


When you give “K a positive numeric argument, it kills that 
many entire lines, starting at the current point on the current 
line. Everything killed is put, as one, on the kill ring, and 
will kill merge with preceding or following killed text as 
described earlier. Where as ESC 4 “K kills four lines, four “Ks 
would not, since you generally must type two “Ks to kill one line 
of text. 


When you give “Y a positive numeric argument, it yanks text 
out of the slot on the kill ring that corresponds to the number 
given. As you have seen, a simple “Y request retrieves the 
latest thing killed, from the first slot. If you want, for 
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example, the second latest thing killed (from the second slot), 
simply give the “Y request a numeric argument of 2 by typing: 


B5G: 2°72 


When you give “@ a positive numeric argument, it "pops" the 
mark off the slot on the mark ring that corresponds to the number 
given; i.e., it sets the current mark at the position where the 
saved mark was originally set. If text was deleted from around 


that position, the current mark is set at the position closest to 
its former position. 


Try all of these requests with numeric arguments until you 
feel comfortable with them. 


Numeric Arguments with Regular Characters 


Whether you realized it or not, regular letters and numbers 
are actually Emacs requests, too. For instance, you know that “D 
means "delete the character at the cursor." What does an 
ordinary d mean? What happens when you type an ordinary d, or 
any number, letter, or punctuation mark? It goes into the buffer 
and appears on the screen. Printing characters (other than #, @, 
and \), are said to be self-inserting, because if you type one, 
it inserts itself into the text. 


Giving a positive numeric argument to a self-inserting 
character causes it to insert itself that many times. For 
instance, if you type: 


ESC 24 Q 


you see 24 Qs appear on the screen all at once. This is a good 
way to get lines of dashes, underscores, asterisks, etc. 


If ever you type a numeric argument, or are in the middle of 
typing one, and decide that you did not mean it, type a “G to get 
you out of it. The reassuring beep verifies that any possible 


numeric argument has been discarded. 


REEXECUTING A REQUEST 


“¢ 


After typing a request, you may just want to repeat it once, 
or to repeat it several times without determining exactly how 
many times. The “C request, reexecute-command, lets you 
reexecute the last keystroke request entered. This request is 
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not especially useful for repeating many of the requests learned 
so far, since it is just as easy to retype them as it is to type 
“C. Some requests, however, require that you type a sequence of 
keys (e.g., ESC F in the section on word requests); typing “Cs 
prevents you from making an error when repeating these. [In 
addition, when you use “C to re-execute a search request, it does 
so, reusing the same search string. 





MULTIPLE EXECUTIONS OF A REQUEST 


“U 


A rather special request lets you repeat requests in a 
couple of different ways. The “U request (multiplier) multiplies 
the next request 4 times for each use. For example, “U"F moves 
forward 4 characters; “U"U°F moves forward 16 characters. This 
request can also be followed by a number, in which case it 
behaves like ESC followed by a number; “U13°F moves forward 13 
characters and “U-13°F moves backward 13 characters. A “U with 
no following number is considered a positive numeric argument. 


Try using “U with various requests that accept numeric 
arguments (except “Y an “@). If you experiment with it, you will 
get an idea of the approximate "space" covered by 4, 16, or 64 
repetitions of the various requests. Then, when something "looks 
about that far," you can type an appropriate number of “Us to get 
in the right neighborhood, at least. 
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ESC: G 


A request that lets you move the cursor to a line specified 
by its line number is ESC G, go-to-line=number, This request is 
especially useful when editing Multics programs, since many 
Multics tools give diagnostics in terms of line numbers in their 
input files. If you happen to be positioned on the first line of 
the buffer, going to the 241st line is easy; just do 240 “Ns by 


typing: 
| ESC 240 7N 


However, if you are on some other line, it is easier to use ESC 
G. This request takes a positive numeric argument that is the 
number of the line to which you want to go. Typing: 


ESC 241 ESC G 


moves the cursor to the beginning of line 241, no matter what 
line you are currently on. If that line is not on the screen, 
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Emacs selects the appropriate area of the buffer and displays it. 
Try it out. 


When you are finished, write out your’ practice file with 
“X°S or “*X*W. For the rest of the tutorial, you can log in or 
out whenever you want a break, and your file will always be there 
to read in if you want some ready-prepared text to work with. 
Otherwise, you can create new text, and files, if you prefer. 
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SECTION 9 


WORKING WITH WORDS 


WHAT'S IN A WORD 


Some of the most useful requests in Emacs are those which 
relate to words. Even if you are typing computer programs or 
other non-English text material, the facility to move around word 
by word, delete words, etc., is very helpful. 


The word movement and deletion requests have a deliberate 
ee with the character movement and deletion requests: 
F, B are forward character, backward character; ESC .F, ESC B 
are forward word, backward word. Similarly, “D and # are delete 
character and rubout character, while ESC D and ESC # are delete 
word and rubout word. 


A “word" in Emacs consists of an unbroken string of upper 
and lowercase alphabetics (a-z and A-Z), numbers, underscores, 
and backspaces. Lower and uppercase letters can be mixed in any 
way. For example, "new payroll", "zeBra," and "begin" are each 
one word; "delete-—char" and "segname$entry" are each two words. 
"March, I said," is three words. 


It will help in learning the following requests if you 
picture to yourself the point, rather than the cursor. Think of 
the point at the left edge of the cursor, between the character 
at the cursor and the character or space just preceding it. 


Also remember that the letters ESC represent the escape key; 
when followed by a space and a character, you type the escane key 
and the character, but not the space. Alphabetic characters are 
given in capitals, but you can type either an upper or lowercase 
letter. Thus, for ESC F, you should type just the escape key, 
release it and type an f or F. 
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MOVING FORWARD AND BACKWARD 


ESC F 


The forward word request, ESC F (forward-word), moves the 
cursor forward over one word. 


e If the cursor is currently on a character that is part 
of some word, it moves to the first character after 
that word. 

@ If the cursor is currently on a character between two 


words (even if they are separated by many blank lines, 
punctuation, breaker bars, etc.), it moves to the first 
character after the second of those two words. 


For example, type in this sentence and position the cursor at the 
beginning of the line (first case, above): 


Yes, it is true. 


Type an ESC F, and the cursor, on the "Y," moves to the comma. 
Now type another ESC F (second case, above). The cursor moves to 
the space after "it." Reposition the cursor to under the e or gs 
in "Yes," and try again (first case, above). Again, the cursor 
moves to the comma. 


THE ESC F request also accepts numeric arguments. To go six 
words forward, you type ESC 6 ESC F. Or, you can type ESC F and 
then “Cs to move forward aword at atime. This request goes 
backward with negative numeric arguments. 


ESC B 
To move backward by words, you use ESC B, backward-word. 


g If the cursor is currently on some character of a word 
other than the first, it moves to the first character 
of that word. 


@ If the cursor is on a character between two words, or 
on the first character of a word (the point would then 
be between two words), it moves to the first character 
of the preceding word. 


Put your cursor under the t in "it" in the sentence just 
typed, and do an ESC B (first case, above). Now, with the cursor 
under the i in "it," try again (second case, above). 
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This request also accepts a numeric argument, moving 
backward the specified number of words (or forward, if the 


(argument is negative). 


The complementary use of ESC F and ESC B is well illustrated 
by the problem of adding parentheses to "Tony" in the following: 


Anthony Tony Burns. 
If the cursor is at the period, the sequence: 
ESC B ESC B ( ESC F ) 


does it. Try it out for yourself. 
DELETING WORDS 


ESC # 


Deleting words is perhaps the second most common editing 
operation (after deleting characters) when entering text. To 
delete the last word you typed, i.e., the word to the left of the 
cursor, you use ESC #, rubout-word. It deletes the word to the 
left of the cursor, or deletes that part of the word to the left 

(> of the cursor if the cursor is in the middle of aword. The 
~"  getion of ESC # is best described as though it were doing “@ 
heey the mark), then ESC B (backward word), and finally “W 
wiping the region). That is to say, ESC # removes all text 
between the cursor's starting point and where it winds up after 

an ESC B. Note, however, that the mark is not really set. 


hoon “tes, 


To summarize: 


@ If the cursor is immediately after a word, ESC # 
deletes only the characters of the word it follows. 


@ If the cursor is in the middle of a word, ESC # deletes 
that part of the word to the left of the cursor. 


® If the cursor is at any other point, ESC # deletes all 
characters between the cursor and the preceding word, 
and that preceding word (intervening punctuation and 
Spaces are deleted, too). 


In your sentence, "Yes, it is true," put the cursor under various 
letters and try to predict what will be deleted before doing 
ESC #s. Be sure to try with the cursor under the i in "it." 


fm 


2 Successive ESC #s remove words farther and farther back. 
Secs This request does kill merging, so if successive words, and the 
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punctuation and white space between them, are deleted by ESC #, 
one “Y retrieves the whole deleted area as it initially stood. A 
numeric argument can also be used with ESC #, deleting backward 
the specified number of words (or forward, if the argument is 
negative). 


ESC. \V77 


Just as the # and the rubout key, represented as \177, had 
the same effect on characters, the ESC # and ESC \177 requests 
have the same effect on words. You can use these two requests 
interchangeably. The command name for ESC \177 is. also 
rubout-word. 


BSC D 


Forward word deletion is performed by ESC D, delete-word. 
It deletes the word, or part of aword, to the right of the 
point, i.e., to the right of, and including the character at, the 
cursor. It deletes forward from the point where the cursor is, 
to the place where ESC F would go. 


& If the cursor is on the first character of a word, ESC 
D removes the entire word. 


@ If the cursor is in the middle of a word, ESC D removes 
all the characters from the one at the cursor to the 
last character of the word. 

@ If the cursor is between words, ESC D removes all white 
Space and punctuation up to the second word, and the 
second word. 


Consider the sentence: 


We have no melons today, Mrs. Johnson.’ 


with the cursor under the r of "Mrs." To replace "melons" with 
"pears", you type: ESC B ESC B ESC B ESC D and then the word 
"pears." The ESC D request accepts numeric arguments. Again, 


try these requests out with your own text by predicting the 
action before typing the request sequences. 


CAPITALIZATION 


ESC L, ESC U, Ese C 
A unique set of capabilities is provided by three requests 


that control the "case" of words, i.e, lowercase (jack), 
uppercase (JACK), or capitalized initial letter (Jack). These 
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three requests are: 
ESC L to lowercase a word (lower~-case-word) 
ESC U to uppercase a word (upper-case-word) 
ESC C to capitalize the initial letter of a word 
(capitalize-initial-word) 
Each of these requests can be issued with the cursor either: 


& on any character of a word, or 


@ immediately after a word to alter its case. 


For example, type: 


thomas 


and leave the cursor right after the "s." To capitalize the 
initial character, merely type an ESC C, and you have: 


Thomas 


The cursor is always left immediately after the word whose case 
is transformed. If you wish to capitalize the initial characters 
of several words, say: 





thomas alva edison 


you can move the cursor to any letter of the word "thomas," type 
ESC C, leaving you on the space after "Thomas," “F to go to 
"alva," another ESC C, leaving you between "Alva" and "edison," 
and “F and a final ESC C, leaving you after "Edison." 


All three word-case-altering requests leave the cursor 
immediately after the word whose case is altered. Since that 
position is a good place from which to issue such a request, you 
can position the cursor after "Thomas" and type, ESC U ESC L ESC 
C ESC U ete., and watch THOMAS, thomas, Thomas, THOMAS, etc., 
replace each other on the screen while you decide which form you 
like. 


These requests deal with all. the characters in a word. 
Thus, a word like "MaGicAl" can be converted to "Magical," 
"magical," or "MAGICAL" by use of these requests. Also, if you 
hold a shift key down too long, ESC C can easily change, for 
example, "MAgical" to "Magical" when you finish typing the "1." 
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@ If a word-case-altering request is issued between 
words, but not immediately after the first one, it 
alters the case of the second word and leaves the 
cursor after it. 


Changing the Case of Regions 


oe lage, 
Two similar requests that also alter case are “X°L 
(lower-case-region) and X°U (upper-—case-region). These two 


requests operate on regions; all letters within the limits of a 
region are made lowercase by “X°L, or uppercase by “*X*U. You 
must, of course, set the mark first, move the cursor to the other 
end of the region, and then issue the appropriate request. For 
example, to add emphasis to this sentence: 


The boy survived for sixteen days in the desert. 


you could set the mark at the "5S" of "sixteen," or the space 
before it, move the cursor to the space after "days" (or even to 
the "i" in "in"), and type “X°U. The sentence would then appear 
like this: | 


The boy survived for SIXTEEN DAYS in the desert. 


For these two requests, the cursor remains where it is, 
i.e., the cursor is not left after the region whose case is 
changed (as it is left after the word with ESC U or ESC L). 
However, you can type these requests one after the other to see 
which result you like best, since the region remains the same. 
You can also make use of “X°X to verify the limits of your 
region. 


UNDERLINING WORDS 


Related to the word-case-altering requests are the 
underlining and underline-removing requests. They cause a word 
to be underlined, or remove the underlining from an underlined 
word. Most current video terminals either do not have the 
ability to underline text at all, or can only do it in a very 
limited way. Therefore, underlined text in Hmacs appears as: 


H\010._\010e_\0101 \0101_\0100 


where "Hello" is wanted. The \010s are backspaces; they are 
shown in this way because almost no video terminals can overprint 
characters, even among those with a limited underlining 


capability. The text in your buffer that will be written out to 
your file actually contains the proper number and placement of 
backspaces, even if the appearance is disconcerting. However, to 
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avoid problems with dprinting text or editing it with other 
editors, do not use backspaces for underlining; use ESC 
instead. | 7 


ESG _ 

Typing in backspaces in order to underline words is 
confusing and error-prone, especially on a video terminal. Thus, 
Emacs provides ESC  , underline-word, for automatically underling 


words. To use this request, position the cursor to: 
9 any place within a word to be underlined, or 
@ immediately after the word 
just as for the word-case-~altering requests. The ESC _ request 


then underlines the word correctly, leaving the cursor 


immediately after the word. In order to get "begin," for 
instance, type b,e,g,i,n, and then ESC _ 





“Z 


The “Z request, remove-underlining-from-word, removes the 
underscores and backspaces from an underlined word. Again: 


@ the cursor can be at any point in the word, or 
e the cursor can be immediately after the word. 


Since this request also leaves the cursor immediately after the 
"de-underlined" word, successive ESC and “Z s add and remove 


underlining from the same word, in alternation. 


LOCATING WORDS 


In addition to searching for and locating a given sequence 
of characters, Emacs can also locate words. In the sentence: 


Yes, I know, Miss Smith's theater 
is the One for me 


Assume that the cursor is ona previous line or in the word 


"Yes," and you want to find the word "is." With “S, the string 
search request, prompting with the string "is" gets you to the 
"is" in "Miss." You could, of course, keep repeating “Ss until 


the right occurrence is located. 
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However, the | word searching request, “XW 
(multi-word-search), locates a word. Type in the above sentence, 
if you have not already, and position the cursor as suggested. 
Now type a “XW. Emacs prompts: 


Word Search: > 


Then type in the word, is, and a CR. The cursor is left 
immediately after "is." 


This word search request finds words regardless of 
capitalization or underlining. You can locate "One" or "me" in 
the above sentence by providing "one" or "me" in answer to the 
prompt. 


This request can also find sequences of words, which is to 
say, several sequential words, separated by any amount of 
punctuation or white space. If the cursor were several lines 
above the sample sentence, you could find it by answering “XW's 
prompt: 


Word Search: i know miss smith CR 
The cursor is left after the "h" in "Smith." Punctuation and 
capitalization make no difference. If you search for the 


sequence "theater is the," you will see that white space is also 
ignored. 


Actually, punctuation and white Space are not really 
ignored, but they are treated the same, as separating one word 
from another. Thus, the sequence: 

“XW jack knife CR 
locates: 

jack knife 

Jack, knife 

Jack... "KNIFE 
but not 

jackknife 


which is one word, not two. 
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LOCATING WORDS BY THEIR PREFIX WITH * 


The word search request can also locate words by searching 
for words that start with a given string. This is useful for > 
searching for long words. To indicate that a word-prefix is to 
be searched for, type the first letters of the word followed by 
an asterisk (*). For example, type a “XW, then anted*, and the 
escape key to search for "antediluvian" or "antedated." You can 
use word-prefixes in this way as part of a word sequence being 
searched for, as well. To search for The "Antediluvian" Era, for 
example, you could answer the prompt with: 


the anted* era OCR 


Like most other Emacs search requests, typing just a CR to 
its prompt uses the last search string provided. The search 
proceeds from the current point in the buffer to the end of the 
buffer. 


There is no reverse word search, but if you Supply any 
positive numeric argument to “XW, e.g., ESC 1 “XW or “U°XW, the 
search begins at the beginning of the buffer. Because this 
request checks for so many things, it can be slow. Therefore, if 
you know what exact characters you are looking for, “S or “R is 
faster. If you know the words, but not the case, intervening 
punctuation, etc., use “XW. 
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MANIPULATING SCREENS AND BUFFERS 


MOVING THROUGH A BUFFER SCREEN BY SCREEN 

Often you wish to "page" through a document, reading through 
it, or glancing over it to locate a certain section to read or 
edit. This is accomplished on Emacs by paging through the text 
screen by screen. You need to be able to see succeeding windows 
to do this. 


“V 


In order to view the next screen, you issue the “V request, 
next-screen, read in your longest practice file and "“V through 
it." Each time you strike a “V, the cursor is left at the upper 
left corner of your screen; not only does the window fill with 
new text, but the cursor also moves to a new place in the buffer. 
If you type a “P after a “V, Emacs chooses a different portion of 
the buffer to display, centering the line of interest. 


With a positive numeric argument, “V pages forward the 
specified number of next screensful, and displays it. With a 
negative numeric argument, it pages backward the specified number 
of screensful (previous screens). 


Note that as you type these “Vs, the first line on the new 


screen is always the same as the last line on the old screen. 
This helps orient you as you go through the text. 


ESC V 


You can also page backward through a buffer. The two-key 
sequence, ESC V, lets you view the previous screen. With this 
request, the first line of the old screen is displayed as the 
last line of the new screen. The command name iS prevescreen. 
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With a positive numeric argument, ESC V moves backward the 
specified number of previous screensful and displays it. With a 
negative numeric argument, it pages forward the specified number 
of screensful (next screens). 


MOVING TO EITHER END OF A BUFFER 


vr eS =i 


Now you can go forward and backward through the buffer 
character by character (°F, “B), line by line (“N, *P), word by 
word (ESC F, ESC B) and windowful by windowful (*V, ESC V). 
However, as with lines, you often need to get to the beginning or 
end of a buffer. What “A and “E do for lines, ESC < and ESC > do 
for buffers. 


ESC < 


The request for going to the beginning of a buffer is FSC <, 
go-to-beginning-of-buffer. Think of the less-than sign as an 
arrow pointing to the buffer's beginning. The ESC < request 
displays the first windowful of the buffer and puts the cursor at 
the very first character. 


Est 7 


The ESC > request, go-to-end-of-buffer, displays the last 
Wwindowful of the buffer and puts the cursor on the newline 
character (the carriage return) that ends the last line of the 
text in the buffer. You cannot move the cursor beyond that 
character. If, after typing ESC >, you see the cursor on a line 
by itself, that simply means that an empty line, one with only a 
newline in it, is at the end of your buffer. 


You can, of course, get to any line between the first and 
last with the other requests learned, especially “P or “N with 
numeric arguments, or ESC Gwhen you know the line number 
desired. 


EDITING MORE THAN ONE BUFFER 

In an Emacs sesSion, each use of the find file request, 
“X*F, results in anew buffer. The “X°F request prompts for a 
filename (pathname of a file), terminated by a carriage return. 


If no existing buffer contains that file yet, “X°F reads the 
file into a buffer, names the buffer by the first component of 
the entry portion of the filename (e.g., names the buffer "first" 
when the filename is >udd>Sales>Smith>first.practice), and sets 
the default file of this buffer to the file just read. 
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If one or more buffers containing the named file do exist, 
they are listed on the screen (see "Listing the Buffers," below). 
You are then prompted to specify the buffer you wish to use: 


Buffer: 


Type a name and end the prompt with a carriage return. If you 
type one of the listed buffer names, “X°F switches to it and its 
version of the file. If you decide instead to use a new buffer, 
give a new buffer name, and “X°F reads the file into it and gives 
this buffer the new name. A blank response for the buffer name 
reuses the buffer named for the first component of the entry 
portion of the filename. 


For example, the first time you read in a file named 
ibm.data, it goes into the buffer named ibm. If you read that 
file again for some reason, Emacs lists the buffers containing 
the file, only one in this case, the buffer named ibm, and 
prompts you for a buffer name. You decide to use a new buffer 
for this copy of the file, and type "new." 


If you read ibm.data in a third time, Emacs lists both "ibm" 
and "new" as buffers containing the file (though they may contain 
different versions of ibm.data if you have edited them). You can 
use yet another buffer by typing a different name, or reuse one 
of these two by typing its name. If you simply type a carriage 
return, Emacs reuses "ibm." 
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“XB 


When you have several buffers containing many different 
files, or containing versions of the same file, you often need to 
Switch from one to the other. The request that does this is. “XB 
(when typing this request, you must release the control key 
before typing b, or you will end up with the “XB request 
described below). The “XB request, select-buffer, prompts for 
the name of the buffer to which you want to go. Type the buffer 
name and a carriage return. 


If the buffer exists, Emacs refreshes the screen with the 
last windowful that you were editing in that buffer, and the 
cursor is placed at the same point where it last was. 


If the name given to the prompt is not that of an existing 
buffer, Emacs creates such a buffer, and displays it on the 
screen (you see an empty window, since the buffer is empty). 
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If you respond to the prompt by typing only a 
return, you return to the last buffer you were in before 
the current buffer. 


carriage 
entering 


When you switch buffers with “XB, the mode line changes to 


reflect the name and mode of the buffer switched to. 


The path 


line also changes to let you know the pathname of the file that 


was read into this buffer, or last written out from it. 


Listing the Buffers and Local Displays 


“X*B 


To list the buffers in use in an Emacs” session, 
“X*B request, list-buffers. This request displays a 


issue the 


list of 


buffers as a local display. A local display consists of 
information displayed at the top of your screen that temporarily 
replaces the text being edited. A line of dashes and stars, like 





this: 


wa *® *%& © &€ 8 & &€ RR HR KR ROW 


is also displayed so that you can tell that your buffer has not 
been destroyed, but simply that a local display is being shown 


"in front of" your text. 


The local display for “X*B contains the name of each buffer 


and the pathname of the file in it, if any. For some 
two symbols, greater-than sign (>) and asterisk (*), 


buffers, 


appear to 


the left of the buffer names. The greater-than sign indicates 
the buffer you are currently editing. An asterisk indicates a 
modified buffer, i.e., a buffer that contains modifications or 


additions that have not yet been written out. Only 


when no 


buffers have an asterisk beside their names will “X°C let you 


exit Emacs without the query, "Modified buffers exist. 


Quit?" 


When you finish viewing the list of buffers in the local 


display, you want to remove it from the screen. If you type any 


editor requests, the local display vanishes and is replaced by 
what was there before it. However you may not want to issue any 


such requests when you cannot see the cursor's location. 


THE LINEFEED KEY AND “J 


A request is provided for just such circumstances. 


It is 


the "no operation" request that does nothing at all! Since 
typing any editor request removes a local display, this request 


can be used to do so without doing anything else. You 
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issue it 
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by striking the linefeed key on your terminal (this is the same 
as “J, noop, on all terminals), preferably two or three times. 


Sometimes, local displays take more than one screen. In 
this case, the last line of the screen says: 


--More?-- (Space = yes, CR = no) 


If you see this, hit the space bar once to see each successive 
screen of the local display. The last screen of the local 
display is indicated by the line of dashes and asterisks; you 
restore the buffer to the screen with linefeeds, when ready. If, 
during a multi-screen local display, you decide you have seen 
enough, typing a carriage return (CR) instead of a space 
terminates the display and restores the buffer to the screen. 


A GARBLED SCREEN 


Occasionally, you may not believe what you see _ on the 
screen. Sometimes bad telephone lines, or unexpected messages 
from Multics, or something you just do not understand may cause 
the screen's contents to become invalid. This may be due to 
hardware problems, bugs in new versions of Emacs, or bugs in your 
terminal. At any rate, you need to clear’ the entire screen and 
put it back the way it ought to be. 


eal 


This is accomplished with the redisplay request, “L, 
redisplay-command. Try typing “L; the sereen clears’ and is 
refilled, with the cursor in the middle of the screen (unless you 
are at the top of the buffer, in which case the cursor is at the 
top). On fast terminals, “L can be used to reposition the window 
so that the line with the cursor on it is at the middle, or to 
remove a local display (using “L for either of these purposes is 
not so useful on slow terminals). 


With a numeric argument, “L redisplays and repositions the 
Window so that the line with the cursor appears at a place of 
your choice in the window. A positive argument gives the number 
of lines below the top of the window that you want the cursor's 
line to be, where the top line is 1 (or 0). For example, ESC 1°L 
moves the current line to the top, ESC 6°L moves it six lines 
from the top, etc. With a negative numeric argument, the 
cursor's line moves to the specified number of lines above the 
bottom of the screen, where the bottom line is -1. For example, 
ESC -2 “L moves to two lines from the bottom, etc. 
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MARKING AN ENTIRE BUFFER 


“XH 


The most common reason for marking an entire buffer is that 
you want to move the text and insert it in another buffer. The 
“XH request, mark-ewhole-buffer, sets the mark at the end of a 
buffer and the point (cursor) at the beginning. This marks the 
whole buffer, although the linefeed at its end is not in the 
marked region. A “W would delete it. The sequence, “XH “W 
a 4s ear go to place in new buffer where you want the marked 
buffer... “Y, effectively moves an entire buffer. 


KILLING AN ENTIRE BUFFER 


“XK 

The “XK request, kill-buffer, kills an entire buffer. You 
are prompted for the name of the buffer to be killed, and end the 
prompt with a carriage return. Buffers are usually killed to 
conserve storage or to remove them from buffer listings given by 
requests like “X*C or “X°B. When: you try to kill the current 
buffer, you are asked for a new buffer to go to. 
SUMMARY OF TERMS 

Two new terms for you to learn are: 


@ local display 


@ redisplay 
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SECTION 11 


HELP 


By this point you may be having trouble keeping track of all 
the requests learned so far. However, whenever your memory of a 
particular request lapses, help is at hand! 


WHAT DOES THIS KEY DO? 


i nl 


When your are not sure what a given key does, you can type 
the ESC ? request, describe-key. This request displays the 
documentation for the request you are unsure of. For example, to 
find out what “V is and does, type £SC ? Emacs prompts in the 


minibuffer: 
Explain Key: 


Now actually type a “V, in the usual manner. A description of 


what “V does appears as a local display at the top of your 
screen: 


“V nextescreen 


Display next screenful of this buffer. Leave cursor 


at upper left hand corner of screen. 


wa *® * € & & & RR 8 8 R HR Fo 





The command name associated with the “V request is 
next-screen (Emacs” refers, in prompts and Emacs-produced 
documentation, to requests as "commands"). The documentation 
describing nextescreen follows the line giving the key name and 
command name, 


11=1 CH27-00 


To clear away the local display describing “V, hit linefeed 
a couple of times. Try ESC ? with a few more requests. 


When you forget what request a given key invokes, or need to 
find out what you just did by accidentally typing the wrong 
request. You can ask for the command name invoked by a given key 
without the documentation to save time. By giving ESC ? a 
numeric argument, e.g., ESC 1 ESC ?, you get this prompt: 


Show Key Function: 


Then type the key in question, say, “W. Emacs responds in the 
minibuffer: 


“W = wipe-region 


EXTENDED REQUESTS 


Some requests are issued by a single keystroke, such as “D, 
which invokes the delete character request, delete-char. Other, 
less common ones, are invoked by two-key sequences beginning with 
ESC, such as ESC ? for describe-key. Still less common requests 
are invoked by two-character sequences beginning with “X or “Z 
(e.g., “X°W). Requests that are the least common have’ to be 
invoked by actually typing in their command names. 


Though some requests are "less common", they are no less 
important. They require more keystrokes simply because you have 
less occasion to use. them. Single keystroke requests” are 
reserved for those tasks that you perform often while editing. 


The requests known as "extended requests" are those invoked 
by typing their command names to Emacs. An example of an 
extended request is "fillon," which enters "fill mode" in a 
buffer. Fill mode sets up a buffer so that you do not need to 
worry about the ends of lines when typing text, and never need to 
type carriage returns (except, of course, when ending prompts, or 
when you want explicit control over the format and line-breaks of 
your document). Fill mode is ideal for typing in text from a 
written page, or composing a document spontaneously. You just 


keep typing; the lines get broken automatically. 


11-2 CH27-00 


PY PT Py TT TT TTT aires 
ogee on TS ST TT 


To invoke an extended request such as fillon, you clearly 

a cannot just.type "fillon." If you did, it would simply go into 

i the buffer like any other characters. You have to let Emacs know 
TT that the next characters are the name of an extended request. 


ESC X 


The request that notifies Emacs to expect an extended 
request's command name is ESC X, extended-command. Type this 


two-key sequence. Emacs prompts in the minibuffer: 

Command: 
Now type the word "fillon" (no quotes, just the six letters), and 
a carriage return. The name of the "fill" minor mode appears in 
the mode line after the name of the current major mode, 
Fundamental. 

In general, you invoke an extended request in this way: 


S type ESC X 


@ type the name of the extended request 


a : @ if the request takes any arguments, type a space and 
a then the argument(s) 
(ae 

| @ type a carriage return 


WHAT KEYS DO THIS JOB? 


ew eee 


apropos 


A very important extended request provides you with all the 
command names, and their associated keys, that relate to a given 
topic. It is used if you remember something about a particular 
request, but you cannot remember the key that invokes it, or what 
its command name is. The apropos extended request finds all 
requests that have a given character string in their command 
name, and provides a local display telling you what keys invoke 
them. The topic that you are interested in is typed, after a 
Space, aS an argument to apropos. 


For instance, suppose you forget which request goes to the 
end of aline. Choose a topic you think is appropriate, since 
apropos must have an argument. If it does not, you get this 
error message: 


~ Wrong number of arguments to extended command apropos. 
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In this case, “end" seems a reasonable choice. So, type ESC X 
apropos (no spaces yet), a space, the argument (end) anda 
carriage return. The apropos request displays the command names 
of all requests available in this buffer whose names contain the 


character string "end." You see “E (go-to-end-of-line), ESC > 
(go-to-end-of-buffer), a few surprises, such as “XM (send-mail), 
and others. Once you learn from apropos what requests are 


available, you may be jolted into recognition ("Right, “E is 
go-to-end-of-line!"), or you may need more information ("Hmm, “*E 
looks right, but I'd like to know exactly what it does.") You 
can, in the latter case, type ESC ? “E to get the full 
documentation. 


The apropos request also lists all relevant extended 
requests if their names contain the specified character string. 
However, you cannot use ESC ? (describe-key) to find out about 
extended requests, since ESC ? prompts for a_ single key, and 
then describes it. If you try to type "fillon" to ESC ?, for 
example, it reads the "f" and tells you that "f" puts an f into 
the buffer. The remaining letters, illon, would go into your 
buffer. 


WHAT DOES THIS EXTENDED REQUEST DO? 


describe 


To find out, then, what an extended request does, you need 
another help request. The describe extended request retrieves 
the documentation for extended requests. Like apropos, it also 
requires an argument; in describe's case, the argument (separated 
by a space from the last character of "describe") is the command 
name of the extended request you are interested in. 


For example, to find out about fillon, you type ESC X, 
describe, space, fillon, carriage return. The documentation for 
fillon is then shown on your screen asa local display. Try 
describe out with the other two extended requests you know, 
describe itself and apropos. 


TANGIBLE HELP 


make-wall-chart 


If you want help in a more permanent and tangible form than 
that provided by ESC ?, apropos, and describe, you can try the 
make=-wall-chart extended request. This puts alist of all the 
currently defined command names and their associated keys into a 
buffer. 
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You should then write the contents out to a file and dprint 
a copy. The list produced in this way, "suitable for framing", 
is a handy reference that you might want to keep near your 
terminal. The wall chart produced is 132 columns wide and the 
requests are divided into three columns. A sample (of one column 
only) appears below. | 


forward-word 
go-to-line-number 
mark-paragraph 


indent-relative 
kill-to-end-~of-sentence 
lLower-case-word 





MORE HELP AND WHAT DID I JUST DO? 


The “~_ request, help-on-tap, provides several forms of help, 
depending on the character that follows it. On some terminals, . 
you may have to type “*? to send the “~_ character. A * 2 
displays the current repertoire of * . A ~H shows where to get 
more help. The ~*~ A and *~ D_ requests are shortcuts for the ESC X 
apropos and ESC X describe extended requests; they work in the 
same way as those two extended requests, respectively. A * °G 
does a “G, as usual, in case you want to get out of help-on-tap. 


Sometimes when. you are happily editing away, things happen 
that you do not expect. If you want to track down your error 
(reconstruct the scene’ of the crime, as it were), you can get a 
local display of the last 50 characters typed in. The “_L 
request provides this, and is very useful as a learning tool. It 
lets you examine what you did so that you can identify and 
correct any problems. 
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SECTION 12 


SENTENCES AND PARAGRAPHS 


Besides being able to recognize and manipulate words, Emacs 
also performs useful manipulations on sentences and paragraphs. 


SENTENCES 


Emacs can go to the beginning or end of a sentence (ESC A, 
ESC E), and can kill sentences either backward (“*X# or *X\177) or 
forward (ESC K). In order to do these editing tasks, it must be 
able to recognize what a sentence is. 


(C Basically, to find a sentence, Emacs looks for period (.), 
question mark (?), or exclamation point (!) followed by at least 
one space or tab. Capital letters have no meaning; Emacs 
sentences need not start with one. If you have numbered items, 
e.ga2 


ee Measure one cup of flour 
Zs Add a teaspoon of baking soda 


Emacs considers "1." to be the end of a sentence (or possibly a 
complete sentence depending on preceding text). The period is 
the last character of that sentence. The second sentence starts 
with the first printed character following the end of the first 
sentence, and contains "Measure one cup of flour," a newline, the 
number "2," and the period. The third sentence starts with the 
wR -OF MAdGs” The end of this third sentence does not appear 
above. However, if the line following this is blank, then "soda" 
ends the sentence; "a" is the last character in it. 


Emacs also considers itself to be at the end of a sentence 
if the point is at the beginning or end of a buffer. 


fx 
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So, to summarize: Emacs actually defines a sentence by its 


ending. Sentences start with the first printed character after a 


previous sentence's end. Sentences end with: 


@ a period, question mark, or exclamation point 
that is followed by white space 


the last character preceding an empty line 


the buffer's end 


Conversely, sentences begin with: 


@ the first printed character following a period, 
question mark, or exclamation point that is followed by 
a space 


the first letter following an empty line 
the first letter at the buffer's beginning 


Moving Forward or Backward by Sentences 


HSC A 


The ESC A request, backward-sentence, moves the cursor to 
the first character of the current sentence, i.e., if the cursor 
is on a character in a sentence, it goes. to the first character 
of the sentence. If the cursor is already at the beginning of a 
sentence, it moves to the first character of the preceding 
sentence. If you supply a numeric argument to ESC A, the cursor 
moves forward the given number of sentences. 


ESC & 


The forward~-sentence request, ESC E, moves the cursor to the 
end of the current sentence, leaving it right after the sentence. 
If the cursor is already at the end of a sentence, it goes to the 
end of the following sentence. Anything defined to be the end of 
a paragraph (see "Paragraphs" below) is automatically the end of 
a sentence as well. This request also accepts numeric arguments. 


Experiment With these two requests until you feel 
comfortable with the concept of Emacs sentences. 


Killing Sentences 
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oo Remember what ESC # did for words? Well, “XA, 

Rod kill-—backward-sentence, does it for sentences. This request 
kills backward from the point to the beginning of the sentence, 
i.e., the first letter following the end of the previous 
sentence. Thus, in the following text, start with the cursor 
under the question mark: 


1. Measure one cup of flour. 2. Add 
an egg. 3. Mix well 


Voila! You have noodle dough. What 
kind of noodles, you ask? 





After the first “X#, the question mark, with the cursor still 
under it, is located where the "W" of "What" was, and that 
sentence is gone. The ? remains because it was not included in 
the text between the point and the beginning of the sentence. 
Subsequent “X#s leave the ? and cursor where the "Y" of "You" 
was, the "V" of "Voila," the "M" of "Mix." Note that the blank 
line is deleted as simply being so much white space between 
sentences. It is this blank line, however, that makes "Voila!" 
be a sentence on its own, rather than a continuation of the "Mix 

Cc. well" sentence, even though no end-of-sentence punctuation 

e follows "well." The next “X#s puts you at the former position of 
"3," the "A" of Add," and so on. 


Sentences killed successively with “X#s merge on the kill 
ring. One “Y retrieves them, as well as the intervening white 
Space, so your text looks the same as it did. This request also 
accepts a numeric argument, killing the specified number of 
sentences backward and entering them on the kill ring. 


ENT 


The “X\177 request (type a “X and then the delete key) is 
also kill-backward-sentence, and behaves the same way as “X#. 


ESC K 


As promised at the beginning of this section, Emacs kills 
sentences forward via the ESC K request, kill-to~end-of~sentence. 
This deletes text going foward from the cursor to the end of the 
current sentence. If you are at the end of a sentence, e.g., the 
cursor is on the space immediately after a period, this request 


CO deletes forward to the end of the next sentence. Sentences 
“\ killed successively are merged, and can be retrieved with a 
\ single “Y. Also, ESC K accepts a numeric argument, killing 
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forward the specified number of sentences; these sentences enter 
the same slot on the kill ring. 


_ Try ESC K out with the sample sentences above. If you typed 
them in before, and killed them with “X#s, you can, of course, 
retrieve them with Y to avoid retyping. 


PARAGRAPHS 


Emacs defines a paragraph in one of two ways, both 
controlled by the "paragraph-definition-type" option of the ESC X 
opt extended request (see Section 17). When this option is set 
to 1, as it is by default, a paragraph is defined as being all 
text between two blank lines. In other words, a paragraph begins 
immediately after a blank line, and ends with the last character 
preceding another blank line. If, after a blank line, you type 
spaces ora tab before entering text on the line, that white 
space is still considered part of the paragraph (unlike white 
Space preceding a sentence). 


When the option is set to 2, an indented line starts a 
paragraph, i1.e., any spaces or tabs at the beginning of a line 
begin a paragraph, and the paragraph ends with the last character 
on the line preceding the next indented line. 


With either option setting, a control line for the runoff or 
compose Multics commands (e.g., a line containing only .sp or 
-spb) is a paragraph all by itself. Paragraphs also begin with 
the line following a "control" paragraph. 


By the above definitions, then, a paragraph always begins at 
the beginning of a line, and the lines must be: 


Type 1 
preceded by an empty line 


a runoff or compose control line 


the beginning of the buffer 


preceded by a runoff/compose control line 


Type 2 
indented 


a runoff or compose control line 


the beginning of the buffer 


preceded by a runoff/compose control line 
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Moving Forward or Backward by Paragraphs 


ESC [ 


The ESC [ request, beginning-of-paragraph, moves the cursor 
to the beginning of the current paragraph. If you are already at 
the beginning of a paragraph, you move to the beginning of the 
previous paragraph. This request accepts a numeric argument and 
moves back the specified number of paragraphs. 


ESC | 


The request for end-of-paragraph is, as you might expect, 
ESC ]j. This moves you to the end of the current paragraph, or 
the end of the next paragraph if the cursor is already after the 
last character of paragraph. You can use a numeric argument to 
move forward many paragraphs. Both ESC [ and ESC | can be tried 
out with the sample recipe, since you have two paragraphs (the 
blank line separates them because they are type 1 paragraphs by 
default). With this type of paragraph, you can type in text, 
Spacing your paragraphs one or two lines apart for an appearance 
both practical and pleasing. kach paragraph can be indented as 
well, but the empty lines determine the paragraph breaks, unless 
you deliberately redefine paragraphs with ESC X opt. 





Marking a Paragraph 


ESC H 


You may decide to delete or move a paragraph, or rearrange 
your text by deleting or moving an entire paragraph. To do this 
you could mark the region with “@, after getting to the beginning 
of the paragraph, then ESC ] to the end of it and issue the “W 
request. However, ESC H, mark-paragraph, makes this easier. It 
puts the mark at the beginning of the current paragraph, and the 
cursor at the end. Your region, in this case a paragraph, is 
marked in one step, and a “W wipes it out. The paragraph is 
saved on the kill ring, and can be reinserted where you please 
with a “Y. 7 


Formatting a Paragraph 


When you just type in text without regard for line breaks, 
your screen's left edge begins to look pretty messy with all the 
continuation lines (\c preceding the text). Since this is such a 
convenient way to enter text, however, Emacs provides a request 
that "tidies up" your text, paragraph by paragraph. 
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ESC Q 


The ESC Q request, runoff-fill-paragraph, formats paragraphs 
for you. It rearranges your text so that words are not broken in 
the middle at the ends of lines. The continuation lines are 
broken, instead, between words, giving you a neat "ragged right" 
margin, and no "\c" lines on the left margin. (You can also set 
your margins; see Section 13.) 


Type in about three lines of text without any carriage 
returns. Type an ESC Q and watch the screen. The text is 
rearranged automatically. Your new paragraph takes up a few more 
Spaces since the sentences have to be rewritten to accommodate 
the new line breaks. You can type in text forever, issuing ESC 
Qs at the end of each paragraph to format it. 


If you want an adjusted right margin, issue ESC Q with a 
positive numeric argument, e.g., ESC 1 ESC Q. To try this with 
the test paragraph just typed, issue an ESC H, “W, and ESC 2 “Y. 
You have marked the formatted paragraph and deleted it, and 
yanked the contents of the kill ring's second slot. These 
contents are the original paragraph, continuation lines and all! 
That is because ESC Q put the unformatted paragraph into the kill 
ring when it formatted it, and it was pushed into the second slot 
by the “W you just did. 


90, ESC Q, without an argument: 


@ formats the current paragraph with a ragged right 
margin 


@ puts the original paragraph into the kill ring 
With a positive numeric argument, ESC Q: 


®@ formats the current paragraph with both left and 
right-justified margins (padding if necessary) 


@ puts the original paragraph into the kill ring 


To set your margins, see “XF and “X. in Section 13. 
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SECTION 13 


INDENTATION AND SPACING 


Kmacs provides numerous requests that deal with indentation 
and the management of white space. White space is any 
combination of tabs, spaces, formfeeds, or vertical tabs. Among 
other things, the Emacs requests discussed here allow you to add, 
delete, and skip over white space characters, as well as add 
varying levels of indentation. 





BLANK LINES 


Adding Them 
“O 


After you have typed in some text, and perhaps formatted it 
with ESC Q, you may decide to add another paragraph or two, or an 
example, or simply a few more lines. The “O request, open-space, 
allows you to insert as many empty lines as you wish so that you 
have a fresh space on the screen in which to work. This request 
also saves the time it might take on some terminals for Emacs to 
continually rewrite lines if you were just typing additional text 
in without first opening a space for it. 


Typing a “O puts a newline into your buffer ahead of the 
current point. Text after the current point moves down a line 
and over to the left margin and pushes succeeding lines down one. 
The cursor remains immediately before the inserted newline, and 
successive “Os keep opening up new empty lines. Thus, to insert 
empty lines above a line of text, issue “O while the cursor is at 
the line's beginning. Your cursor is then positioned so that you 
can issue as many “Os as desired, and then immediately start 
typing the new text, since the cursor is right after the last 
inserted newline at the top of the stack of empty lines. With a 
positive numeric argument, ‘°O inserts the specified number of 
newlines. Thus, “U"U"O, or ESC 16 “0, opens up 16 lines. 
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Removing Them 


“X70 


If you open up more space than you need, or simply have 
blank lines that you donot want, “X°0, delete-blank-lines, 
removes them. 


If the cursor is anywhere on a non-blank line, issuing “X70 
deletes all blank lines after the end of the current line. The 
cursor is left at the end of the deleted blank lines, i.e., at 
the beginning of the next non-blank line which has moved up (with 
all succeeding lines as well) under the line in which “X°0O was 
issued. 


If the cursor is on a blank line when you issue “*X“0O, again, 
all blank lines after the end of the current line are deleted. 
Thus, you still have one blank line remaining (blank lines above 
also remain, of course). The cursor is left at the beginning of 
the next non=-blank line. 





Try these two requests out for yourself to see how easy it 
is to open up space, type, and delete the extra. 


DEALING WITH WHITE SPACE ON A LINE 


Spacing Over Indentation 


ESC M 


A simple request, ESC M (skip-over-indentation) lets you 
move the cursor over the white space beginning the current line. 
The cursor moves to the first non-blank position on the line. 
This helps get you right to the text after you have issued a ‘A, 
ESC [, or similar request moving you to the beginning of an 
indented line. In fact, if you are anywhere in an indented line, 
ESC M moves the cursor to the non-blank at the beginning of the 
line, so it is frequently more useful than a “A when working on 
indented text. 


Deleting White Space 
ESC \ 


The ESC \ request, delete-white-sides, deletes all white 
Space surrounding the point on the current line, and closes up 
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the line accordingly. Thus, issuing an ESC \ with the cursor at 
any of the spaces between "have" and "too" or on the "t" of "too" 
in the following: 


I have too much space here. 
gives you 
I havetoo much space here. 


with the cursor left under the "t." Putting the cursor under "[" 
and typing ESC \ removes the indentation. The point is always 
left before the first non-white space character that followed its 
prior position. 


ESC “* 


The ESC “~ request is not issued by typing the escape key and 
the control key. The """ here represents the caret character on 
your keyboard, so you type the escape key and then the caret. 
This character is commonly referred to in Multics as the "not 
symbol." ESC “, delete-line-indentation, deletes all the white 
Space at the beginning of the current line and merges it with the 
previous line. The cursor can be anywhere in the line when you 
type the escape and caret key sequence, and it moves to the first 
non-blank character that began that line. Thus, it usually ends 
up somewhere in the middle or toward the end of the previous 
line. Following text moves up to the vacated line. 


With a positive numeric argument, ESC * does a “N first, 
deleting indentation on the next line and adding it onto the. 
current one. In this manner you can connect lines to each other 
and remove indentation if you decide to change the appearance of 
your text. For example, to change the following: 


Mail copies to: 
Bob Burns 
Cindy Hatter 
Jake Voit 
to; 
Mail copies to: Bob Burns, Cindy Hatter, Jake Voit. 
simply put the cursor on the top line and type (type the 
characters indicated within the brackets, not the brackets and 
letters enclosed): 


“y ESC* <2 spaces> “U ESC* <,space> *U ESC” <,space> “E <.> 
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Alternatively, you can start with the cursor on the last line, 
and type: 


ESC” <,space> ESC” <,space> ESC” <2 spaces> “E <.> 


The first way, using anumeric argument, is a little more 
intuitive. 


FILL MODE 


Fill mode is a minor mode that can be turned on or off in 
each buffer. If it is on, i.e., you are "in fill mode," text is 
broken automatically at the end of each line so that it does not 
extend past the fill column. The fill column determines the 
right margin, and is the first column in which text is not to be 
placed by ESC Q or fill mode formatting. Typing a space, tab, or 
punctuation mark following aword that passes the fill column 
signals Emacs to "back up" to the white space preceding that word 
and break the line there. In addition, the fill prefix, if set, 
is inserted at the beginning of each new line typed in while in 
fill mode. The fill prefix determines the left margin, and is 
empty unless set to contain some combination of spaces and 
characters (see "Margins," below for changing the till prefix and 
fill column). If the fill prefix is not set, i.e., it is empty, 
the left margin is the left edge of your screen. 











While in fill mode, if you do want characters in or beyond 
the fill column, type a carriage return immediately after the 
word instead of a space, tab, or punctuation. Or, if you want 
more than a word, precede each character after the word with “Q. 
Alternatively, you could reset the fill column for that line. 


Fill mode is an excellent means of entering text without 
ever having to worry about the ends of lines. Your text is 
formatted automatically as you type, so you can enter your 
document rapidly and see how it looks immediately. Use this mode 
whenever entering English text for maximum convenience. 


ESC X fillon AND ESC X filloff 


These two extended requests, as their names imply, turn fill 
mode on or off in a buffer. When entering text, you generally 
want to be in fill mode, since you can then simply type without 
ever worrying about carriage returns or line breaks. Your text 
is formatted as you type. 
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MARGINS 


- Your right and left margins are generally set automatically 

oe to accommodate your terminal's screen size, thus maximizing your 
working space. You can, however, change these margins. The left 
margin can be reset by setting the fill prefix, which is inserted 
automatically ty carriage return, fill mode, and ESC Q. The fill 
prefix can contain characters and spaces and it "prefixes" all 
text following a carriage return or formatted by fill mode or ESC 
ae Generally, you want only spaces in the fill prefix. The 
right margin is determined by the fill column, which is the first 
column in which text is not to be placed by ESC Q or fill mode 
formatting. 


setting the Margins 


pe 


The “X. request, set-fill-prefix, sets the fill prefix in 
the current buffer. You position the cursor on a line and type 
ea Whatever is between the cursor and the beginning of the 
line becomes the fill prefix. So, if you want a fill prefix of 
five spaces, put the cursor on the sixth character of a line 
beginning with at least five spaces and issue this request. A 
good way to do this is to choose a line indented the way you want 

oO it and type an ESC M and then “X.. Existing text does not 
iW change, but subsequent ESC Qs and carriage returns indent text. 
If fill mode is on, future lines are also indented. 


By positioning on a line whose beginning contains non—-blank 
characters, you can include them in your fill prefix. You might 
want a fill prefix containing asterisks or dashes, for example, 
to set off a section of your text. To return things to normal, 
j.e., have no fill prefix, issue “X. at the beginning of a line 
(“A gets you out to the left edge before the fill prefix). 


“XF 

To set the fill column for the current buffer, use “XF, 
set-fill-column. The column in which the cursor is located when 
you type “XF is set as the fill column. Fill mode and ESC Q use 


this column as the right margin. When you set it, the value is 
displayed in the minibuffer like this: 


Fill column = 65 


Poo 
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This request accepts an optional positive numeric argument, which 
is the value to be assigned to the fill column, e.g., “U 65 “XR 
sets column 65 as the fill column and makes column 64 be the last o 
column in which text can be placed when you are in fill mode, or ) 
formatting with ESC Q. : 


If you are dprinting a file on a device that accommodates 
more characters/line than your terminal, you may want to set the 
column to an appropriately higher value to save time and paper. 
Remember, if you do this, that your text on the screen will 
necessarily include many continuation lines (\c inserted at the 
beginning of the lines, with words broken randomly). 


Centering a Line 


ESC 5S 


The ESC S request, center-line, centers the current line 
between the left edge and the fill column. This is useful for 
headings and titles, but only if the fill prefix is not set. If 
it is, you end up with everything "centered" too far to the left. 
Experiment with ESC S with different settings of the fill prefix 
and fill column. 





MORE ABOUT LINES AND WHITE SPACE © | = 


Shearing a Line 


ESC *O 


This request, ESC “O, named split-line, breaks the line at 
the point. The text beginning at the cursor is moved down a line 
and indented so that it stays in the same column vertically. The 
cursor maintains its original position. Thus, you can change: 


Kit contains: embroidery thread, stamped cloth 
Items needed: needle, hoop 


GOs 
Kit contains: : 
embroidery thread, stamped cloth 
Items needed: 
needle, hoop 
by putting the cursor at the "e" of "embroidery" and typing: 


ESC *O “N “*N ESC “O > 
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Since “N tries to stay in the same column, it is Simple to move 
the cursor down to the "e" again. The second “N is all that is 
necessary in this case since "needle" was already directly below 
"embroidery." In your editing, however, you will have to make 
sure the cursor is positioned where you want the line to be 


sheared. 


Now recall what ESC * (caret character) does with a numeric 
argument. It removes the indentation from the next line and 
tacks the remaining characters onto the current line. So, after 
you type the sequence above, leaving the cursor two spaces after 
"needed:", you can simply type “U ESC * to rejoin the bottom 
lines. A “P followed simply by ESC “~ rejoins the top two (since 
ESC ~ by itself removes indentation on the current line and tacks 
the remaining characters onto the previous line. 


Undenting to the Fill Prefix 


ESC “I 


If you have an indented-line that you no longer want 
indented, you "undent" it with ESC “I, indent-to-fill-prefix. | 
This only works if the indentation is caused by something other 
than the fill prefix, since the request removes leading white 
space and replaces it with the fill prefix. When the fill prefix 
is not set, ESC “I effectively moves the first non-blank 
character of the line over to the screen's left edge (moving the 
rest of the line with it, of course). When it is set, ESC “I 
simply removes the white space, leaving the first non-blank 
character after the fill prefix. In either case, the cursor, 
which can be anywhere on the line when ESC “I is issued, moves to 
the first non-blank character. 


INDENTATION 


Emacs provides a sophisticated method for indenting when you 
are preparing outlines, programs, tables, and other indented 
text. 


ESC I 


ESC I, indent-relative, is avery powerful Emacs request. 
It indents the current line like the previous non-blank line. 
Thus, if you want to set in several lines, and line them up with 
each other, you can simply type an ESC I anywhere on each line as 
you are typing the text, or add them while editing. 
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You can easily add another "level" of indentation by typing 
ESC I onaline that is already indented. Doing so re-indents 
the first non-blank character on the current line to the column 
occupied by the first letter of the next word on the right, 
above. Thus, if you have: 


Top level, no indentation on this line. 
second level, line indented five spaces. 
Current line, indentation varies. 


you can type another ESC I on the third line to get: 


Top level, no indentation on this line 
second level, line indented five spaces. 
Current line, indentation varies. 


As you can see, the third line is now indented to line up under 
"level," the first word beginning to the right of "Current." 
When re-indenting with ESC I, Emacs again uses the previous 
non—blank line, so the effect of typing ESC I twice on the third 
line would be the same if it were the fourth line and followed a 
blank line. 


Generally, however, you prefer your "re-indentations" to be 
less haphazard than lining up with the next word above, so you 
would probably use the space bar for the first level of 
indentation, type in your additional line(s) at that level, and 
again use the space bar to set a second level. Each ESC I after 
indenting a line to this second level also indents to the second 
level, Since ESC I uses the previous non-blank line's 
indentation. However, if you are typing data into a table, for 
example, ESC I can be very effective in re-indenting, since the 
"next words" in the lines above start in the desired columns. 


ESC CARRIAGE RETURN 


If you are indenting several lines, you do not have to type 
a carriage return (CR) after each line and then an ESC I to 
indent the next. The ESC CR request, cret-and-indent-relative, 
combines these two functions for you (very useful unless you are 
in fill mode so you are not typing carriage returns anyway). 
This request does a carriage return and an ESC I in one step. 
S0, you can end the current line and start a new one indented the 
same just by typing ESC CR. If the current line is not indented, 
the new line starts under the first letter of the second word on 
the original line. fry this out by entering the following: 
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Document preparation should be made as easy as possible. 
a (Documents is used loosely here to include memos, 
ard business letters, theses, professional papers, user 


manuals, instructional booklets, advertising copy, 
and any other informational type of text that we need 
for doing our jobs.) 

Emacs helps by simplifying text entry and editing. 





In addition to trying the above, experiment with ESC I and 
ESC CR with several levels of indentation. 


Two-Column Format 


Section 17 describes, under "Comments" several requests that 
can be used to format your work in two columns. You can 
manipulate the comment column and comment prefix (somewhat like 
the fill column and prefix) so that you have two columns. If you 
wish to do this, see Section 17 and experiment with these 
requests. 


SUMMARY OF TERMS 


(_ some new formatting terms introduced in this section 
a include: 


@ fill mode 
® fill prefix 
@ fill column 
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SECTION 14 


MOVING BLOCKS OF TEXT 


Regions, paragraphs, and buffers can be marked, deleted, and 
yanked back into new positions whenever you want to move then. 
The “@, “XH, and ESC H requests are the principal means of 
marking large sections of text that you have learned so far, and 


“W deletes any section so marked. The “Y and ESC Y requests are 
available for retrieving killed text blocks and inserting them at 
the cursor. In addition to these requests, Emacs provides some 


more sophisticated methods of marking and moving blocks of text. 


INSERTING AN ENTIRE FILE 


“XI 


The “XI request, insert-file, allows you to read additional 
files into your text. You position the cursor to where you want 
the file inserted, and issue this request. You are prompted for 
the pathname of the file you want: 


Insert File: 


Type the pathname and end it with a carriage return. The word 
"Reading" flashes on in the minibuffer while the file is read in 
before the cursor, i.e., to the left of the cursor. The cursor, 


and the text of the original buffer at and following the cursor, 


are then left after the contents of the inserted file - after the 
newline at its end. Your buffer's previous contents are 
preserved, and the new file becomes part of them. The default 
file for the buffer remains the same. So, if you originally read 
in "first.practice" with “X*F, and insert "second.practice" with 
“XI, a “X°S or “X°W with an empty prompt response still writes 
the file out to "first.practice." 





With “XI you can insert as many additional files into the 
current buffer as you wish, or insert the same file at many 


places. You can, of course, insert other people's files by 
giving the appropriate pathname (you must have the proper 
access). This can be very helpful if several people are working 
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on different sections of a document; you can "assemble" the 
various pieces by inserting the files in any desired sequence. 
(Alternatively, you can assemble a document with the runoff or 
compose command's insert file controls.) 


COPYING A REGION 


ESC W 


Nometimes rather than moving a block of text from one place 
to another, you simply want a copy of it in one or more 
additional places in your text. Rather than wipe it with “W and 
then yank it back into both the original and secondary 
position(s) with “Ys, you can co it with ESC W and “Y it into 
the new position(s) only. ESC ~ copy-region), then, copies the 
region between the cursor and the mark, placing a copy in the 
kill ring without affecting the original. | 


SELECTING AND JOINING TEXT ON THE KILL RING 


ESC “W 


To join two disparate pieces of text, you can issue the ESC 
“W request, merge-last-kills-with-next. This causes the next 
kill requests, which must follow immediately, to merge what they 
kill with the last saved kill on the kill ring. Then one “Y 
retrieves them as a single entity. For example, typing: 


“A “K “K “N “N ESC *W °K °K 


catenates two disjoint lines on the kill ring. 


NAMED REGIONS 


Emacs provides a way to assign a region to a variable, whose 
name you choose, so that you can manipulate it at any time during 
an editing session, i.e., during the same invocation of emacs. A 
variable is simply a stored region. Variables are maintained for 
the entire session, so you can work with several named regions at 
once, instead of the single one defined by the mark and point. 





Storing the Region to a Variable 


“XX 
The “XX request, put-variable, stores a region away by name. 


To use this request, you set the mark and point around your 
chosen region, and type “XX. Emacs prompts you for a name to be 
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associated with the stored region: 
Oo Variable: 


Type whatever name you choose, ending with a carriage return. 
The region then disappears from the screen, and the cursor 
returns to the character which preceded the region. You have not 
lost this text; it is merely stored away, and is retrievable by 
name. You can store as many regions in this manner as you wish. 
However, be careful not to duplicate names, because Emacs 
overwrites a previously stored region if you try to store another 
one in the same variable. 


Inserting a Variable 


“XG 


You use “XG, get-variable, to retrieve or insert a stored 
region at the cursor. You are again prompted for the variable 
name, and the named region reappears in your text at the cursor 
after you type the carriage return. The cursor is put after the 
reinserted region, and the mark is set before it. You still have 
this same region stored as a variable, however, so you can move 
the cursor and issue additional “XGs to get more copies into your 
text. 


Listing Your Variables 


ESC X lvars 


If you forget what your variable names are, or you want to 
check them to avoid duplication, the ESC X lvars extended request 
lists them for you in alocal display. It also provides the 
length of each variable, which may give you a clue to what is in 
them if you cannot remember. The display looks like this: 


Current string variables 


Name #Chars 


footnote og 
stars 12 
disclaimer 54 





You can type a linefeed ("J) or resume editing to get rid of the 
C. local display. 


Brean at 
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NAMED MARKS 


You.can also assign names to marks in much the same manner 2 
as you assign them to regions as variables. This can be ) 
extremely helpful for setting up a series of places in your text 
to which you want to return for some reason. Perhaps you want to 
doublecheck several items, but do not wish to keep interrupting 
your text entry or editing. Or you may be considering a format 
change that will affect several parallel points. Even if you 
Simply have several "rough spots" that you know will require 
further work, you can return quickly and easily to any spot where 
you have set a named mark. However, named marks, unlike 
variables, are valid only in the buffer in which they are set. 








Setting a Named Mark 


“Z"@ 


The “Z°@ request, set-named-mark, sets a named mark at the 


current point. You position the cursor, type “Z°@, and respond 
to the prompt: 


Mark Name: 


with whatever name you choose, terminated by a carriage return. 

The minibuffer prints a message telling you that the mark is set me 
and giving its name. Until you set, or set and name, another | )) 
mark, this named mark remains the effective mark, so you could ae 
move the cursor and “W whatever region the named mark and point 
define. Remember, too, that if you change buffers, you can reuse 
the names assigned to marks set in different buffers, since 
“Z°@-created named marks are valid only in the buffer in which 
they were set. If you do not change buffers, reusing a name 
reassigns the named to the current mark. 


Going to a Named Mark 
“ZG 

The “ZG request, go-to-named-mark, moves the cursor to the 
point where the named mark was set by “Z°@. You are prompted for 


the name. Use this request to return to any point where you had 
the forethought to set a named mark. 
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Listing Your Named Marks 


ESC X list-named-marks 


The ESC X list-named-marks extended request is provided for 
the same reasons as ESC KX Ilvars. It lists the line number and 
the name for each named mark in a local display that looks like 
this: 


Mark name 


snow 
white 
disclaimer 





SUMMARY OF TERMS 


You can move text by several means now, including inserting 
entire files and copying regions. You can also move text, or 
Simply move around, by assigning names to regions and marks. The 
following terms are important for you to remember: 


®@ variable 
@ named region 
@ named mark 
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SECTION 15 


KEYBOARD MACROS 


A keyboard macro is a sequence of requests (and, possibly, 
characters to be entered) that are performed, in order, when you 
issue a macro-executing request. It is a "mini-program" that you 
devise to perform some editing task that you must do several 
times. You can create and use a macro, and then create a new 
one, or you can save your macros for later use by assigning names 
and keys to them. The most important thing to know about a 
macro, though, is that it is easy to create one. Basically, you 
issue requests to perform some. task, only before doing so, you 
tell Emacs to remember the requests as a macro. 


CREATING A MACRO 


When would you create a macro? Well, suppose you are 
preparing a document and decide that you want a section of text 
to be highlighted by a column of leading asterisks and 
doublespaced. You can write a macro that inserts the asterisks 
and blank lines for you. 


“X( AND “X) 


The “X( request, begin-macro-collection, is the first thing 
you type to start writing a macro. When you type it, Emacs 
begins "remembering" your next keystrokes as a macro. 5So, before 
typing it, you should always define your problem and decide what 
Emacs requests you would issue to correct it once (you could 
actually make the correction one time to verify this). Then type 
“X(. This appears in your mode line, after the name of the major 
mode: 


<Macro Learn> 
Macro Learn is a minor mode, entered via “X(. Now everything you 
type, until you make an error or issue the “X) request, 


end-macro-collection, becomes part of your macro. When you do 
type “X), the "Macro Learn" message disappears. 
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Thus, to insert the asterisks and blank lines you would 
define this macro: 


“X( “X “A * <2 spaces> “E “O ESC 2 “N “*X) 
“X( begins the macro definition. 
“A puts you at the beginning of the line. 


* and two spaces following inserts an asterisk and two 
spaces before the rest of the line. 


® “E puts you at the end of the line, which now begins 
with an asterisk. 


& “O inserts a blank line after the current line. 


@ BSC 2 “N moves you two lines down, past the new blank 
line to the next line with text, leaving you ready to 
repeat the macro. 


& “X) ends the macro definition 


The “X) request accepts a numeric argument; if given one, it 
executes the macro as well as ends its definition. The number of 
times it executes it depends on the numeric argument. See 
"Executing a Macro" below for details. | 


EXECUTING A MACRO 


“XE 


After a, macro has been defined, “XE, 
execute-last-editor-macro, executes it once. The macro’ to be 
executed with this request must be the latest one written with 
“X( and *X). With a numeric argument, “XE executes the macro the 
number of times specified by the argument, according to the 
following: 


Numeric Argument Executions 


0 Repeats execution, with a pause 
(i.e., ESC O “XE) after each, as long as you type 
a space during the pause. 
Typing a carriage return or 
“G stops the repetition. 


1 - 9999 Repeats execution the 
(e.g., ESC 6 “XE) specified number of times. 
>»9999 Repeats execution until an 


error occurs. 
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The “X) request, which ends a macro definition, can be given 
a numeric argument, too, specified right in the macro. The 
numeric arguments are interpreted the same as those for “XE, 
above. After you type the “X), execution starts automatically. 
Try executing the macro you typed that inserts paragraph "breaker 
lines." 


MID-MACRO QUERY 


“XQ 


What if you want to execute a macro selectively, i.e., have 
it affect some cases and ignore others, or stop executing 
altogether? While you are creating a macro, you can write the 
“XQ request, macro-query, into it so that Emacs will stop in 
mid-execution, letting you control how or whether it continues. 
You simply type a “XQ into your macro at the point where you want 
the pauses to occur. A message appears in the minibuffer: 





Inserting query at this point. 


During execution of the macro, Emacs performs as much of the 
macro as precedes the query, then stops and asks you, in the 
minibuffer, ‘"ok?". You must the type one of the following 
responses: ; 


e A space (hit the space bar) continues execution of the 
macro; the requests following are performed. 

& A carriage return starts the macro over from its 
beginning, without performing the requests following 
the query. 


@ A “G stops the macro altogether. 


Using “XQ, then, type in this macro (spaces should not be 
typed, or they will be inserted into your buffer. They are 
included in the examples only for readability.) 


“x( ESC] *XQ *O **------------ ¥* *X) 


This macro goes to the end of the current paragraph (by finding a 
plank line or indented line), queries you, and then opens a new 
blank line and inserts the asterisks and hyphens. During its 
execution, you are queried at the end of each paragraph. Typing 
a space in response to the query opens a blank line and fills it 
with the supplied characters to form a more visual break between 
paragraphs. Typing a carriage return (perhaps because the 
"naragraph end" is not really the end of one of your paragraphs 
or you do not want the current paragraph to be set off) goes to 
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the end of the next paragraph without adding a blank line and the 
asterisks and hyphens. 


DISPLAYING A MACRO 


ayx 


The “X* request, show-last-or-current=-macro, provides a 
local display of the last macro defined with “X( and *“X). The 
requests are shown as keystrokes, like this: | 


esc- | “XQ i © i ee ee HRN 


Character strings within the macro are quoted. 


If you give this request a numeric argument, e.g. “U°X*, 
the keystrokes and command names are displayed. Try it out to 
see what this display looks like for the macro you typed in. 


SAVING A MACRO 


ESC X save-macro 


You can save the current macro by assigning a command name 
to it. At the same time, you can assign a key to the named 
macro, so that you only need type the assigned key to execute the 
macro. When you invoke the ESC X save-macro extended request, 
you are prompted for a command name to assign to the macro, anda 
key sequence: 


Macro Name? paragraph-stars 
On what key? 


If you type “X9, for example, to the second prompt above, you 
get: 


On what key? “X (prefix char): 9 


A null response to the key prompt does not assign paragraph-stars 
to any key; the ESC X set-key extended request, described below, 
can be used later to assign a key. Keys assignments made with 
ESC X save-macro and ESC X set-key are only effective in the 
current buffer. 


Once a key has been assigned, typing it invokes the macro to 
which it is assigned. The key can be given any of the numeric 
arguments accepted by “XE. Be careful when setting the key that 
auto-linefeed is turned off on your terminal, or you end up with 
“J as your key every time. 
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To check your key assignment, invoke ESC ? with the new 
key. This display appears: 


“X9 paragraph-stars 


“X9 is a keyboard macro. Type esc-X show-macro 
paragraph-stars to display its definition. 


Had you assigned one of the keys already used for a Fundamental 
mode request, you could still issue the Fundamental mode request 
as an extended request. Simply type an ESC X and the command 
name to do so, e.g., HSC X put-variable, if you wish to assign 
“XX to a macro. Actually, you can issue any standard Emacs 
request as an extended request, at any time. 


Displaying a Saved Macro 


ESC X show-macro 


The ESC X show-macro extended request displays a macro that 
you have defined with *“X( and ‘°X), and then assigned a name to 
with ESC X save-macro. When invoking this request, you must type 
the name of the macro as an argument, after typing ESC X 
show-macro and before typing the carriage return that terminates 
the prompt. The local display is the same as that for “X*. 


EDITING A MACRO 


ESC X edit-macros 


The ESC X edit-macros extended request produces a symbolic 
file of all keyboard macros defined in the current buffer, and 
places it in anew buffer called "Macro Edit." The keyboard 
macros can then be written out for later loading, and can be 
edited, redefined, or compiled into Lisp code. This request is 
also helpful if you have forgotten what macros are available to 
you. For information on the other uses of ESC X edit-macros, see 
Appendix D. 


SETTING AND CHANGING KEY BINDINGS 


ESC X set-key and ESC X set-—permanent-—key 


You can assign your own key bindings to requests and named 
macros with the ESC X set-key and ESC X set-permanent-—key 
extended requests. The former assigns the key only in the 
current buffer, and the latter assigns the key in all buffers. 
Aside from this, both requests work in the same way. 
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After typing in either request, you must provide two 
arguments before ending the prompt with a carriage return. The 
first argument is the key name; the second is the command name. 
These requests make the key, assigned by the key name, execute 
the request, specified by the command name (either in the current 
or all buffers, depending on which key-setting request is used). 








The command name can be any standard Emacs command name, or 
the command name that you have assigned to amacro via ESC X 
Save-macro. 


The key name can be the typed representation of a key, i.e., 
you must type out the letters or characters that represent any of 
the special keys, rather than typing the special key. For 
example, in a key name, you can type the word "control" or the 
caret character, but not the control key. Likewise, you can type 
the letters "meta" or "m", but not the meta key (found, for 
example, on Massachusetts Institute of Technology Knight TV 
consoles or Stanford Artificial Intelligence Laboratory 
consoles). Key names can have any of the following forms (angle 
brackets are included to delineate components that are not 
Ji tera): 


@® <syllable> e.g., “f (caret f) - a single 
keystroke 
@ esc-<syllable> e.g., esc-f or ESC-f 
escape-<syllable> escape-f 
meta—-<syllable> meta-f 
m—-<syllable> m-f (2 keystrokes, where the 


first is the ESC, or a single 
keystroke where the meta key is 
held down) 


@® <syllable><syllable> e.g., “XC 
<syllable>-<syllable> e.g. “Z-"@ (2 keystrokes, where 
the first is some prefix 
character - not the ESC key) 


A syllable can be: 


@ “ (caret character) (this represents the actual caret 
key, as in esc-") 

® “<character> (where character can be any of 
the upper or lowercase 
alphabetics, which are 
equivalent, or [, ], \,» *» ., or 
@. These are interpreted as 


control characters) 
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e e~<character> (character is the same as above; 
these are also control 
characters) 

ctl-<character> 
control—-<character> 


& esc (where these are all letters or 
CR characters representing special 
NIGEL keys, and upper and lowercase 
TAB letters are equivalent) 


Space or sp 


® <character> (where, if the first syllable is 
7 eh the <syllable><syllable> 
forms, the character is 
restricted as above. If the key 
name is simply this one syllable, 
uppercase assigns a different key 
from lowercase. This is the only 
syllable type where upper and 
lowercases are not equivalent. 


Always remember that you do not actually type any special 
keys, but only their representations. In general, if you are 
unsure if a key name is acceptable or not, use a form like one of 
those found in this manual. Some choices that are valid are not 
Suitable, e.g., a space or alphabetic alone, since you probably 
need those characters when entering text. , 


EXAMPLES OF ACCEPTABLE FORMS OF KEY NAMES 


a "x 

“Xq “Pp 
ESC-ESC esc- f 
c=-p CR 
control-p “X-"FR 
Le ar a “X-CR 
# meta-f 
Xx TAB 

sp SPACE 


See the wall chart (made via ESC X make-wall-chart) for more 
examples of valid key names. 
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Two examples of setting keys are given below: 
ESC X set-key “T quit—-the-editor 


allows you to quit the editor, from the current buffer, in one 
keystroke. After setting this key (by typing in a caret and a 
t), you quit the editor by typing, in the usual way, a “T. 


ESC X set-permanent-key “X9 paragraph-stars 


locates the end of the current paragraph and inserts a blank line 
and a breaker line of asterisks and dashes whenever you type a 
“X¥9 in any buffer. 


The user should be aware of the following equivalences 
between characters. On any ASCII terminal, the linefeed key 
generates a “J, ete: 


MONO: = “H = backspace 

\OLt <= “TL = TAB 

\Oi2: = “J = linefeed 

\O1s <= “K = vertical tab 
\O14 = “L = formfeed 

\O15 «= “M = carriage return 
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SECTION 16 


MULTIPLE WINDOWS AND THE BUFFER EDITOR 


Emacs allows the editing of many documents at once; 
documents are read into buffers, and Emacs can have as many 
buffers as needed. A unique feature of Emacs, however, is that 
of displaying multiple documents on the screen at once. This is 
very useful when writing one document while reading another, such 
as responding to mail, correcting programming errors while 
reading compiler diagnostics, merging or comparing programs, and 
so forth. 


Multiple documents (more precisely, multiple buffers) can be 
displayed by dividing the screen into windows. Normally, the 
screen consists of one window, called the main window. When you 
switch buffers (for instance, with the “XB (select-buffer) 
request, the new buffer is displayed in the main window, and the 
mode line is updated to indicate which buffer is on display in 
that window. 


You create new windows with the window-creating requests, 
described below, andcan display any buffer in any of these 
windows. The windows are divided from each other on the screen 
by lines of dashes (-------- ys The cursor is always in some 
particular window; that window is called the selected window. 
You select awindow i.e., move the cursor into it, with the 
window-selecting requests, or the window editor. When a window 
is selected, the buffer on display in that window is being 
edited, and all the Emacs requests can be used on text it 
contains. 


An optional feature, called pop-—up-windows, in which windows 
are created as needed by various Emacs requests, and windows are 
destroyed as space is needed, is described in Appendix H. 
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Before the descriptions of the common window-manipulation 
requests, here are some terms used in talking about windows: 


® buffer - a body of text in Emacs identified by a buffer 
name. You are already familiar with this concept. 


@ window - an area of the screen delimited by "boundary 
lines", i.e., lines of (----- ), the top of the screen, 
or the mode line. A window is said to be displaying a 
buffer if the text of that buffer can be seen in that 


window. 

& "on display in" - a buffer is on display ina given 
window if the text of that buffer can be seen in that 
window. 

@ topline -— the boundary line on the top of a window. 


The uppermost window has no topline. 


@ bottomline - the boundary line on the bottom of a 
window. The bottom-most window has no bottomline. 


) selected window -—- the window in which the cursor now 
appears (when not in the minibuffer). 


@ current buffer - the buffer on display in the selected 
window. The mode line gives the name of the current 


buffer. 

® LRU window -— the least recently used window, i.e., the 
window which has been the selected window least 
recently. 

@ previous window - the next-most recently used window 


other than the selected window itself. The selected 
window is always the most recently used. 


There are several basic techniques for manipulating windows. 
The simple keyboard requests “XO, “XO, “X1, “X2, *X3, and “X4 can 
be used to create, destroy, and select windows. At low speed, 
this may be the only convenient way to edit several "pages" at 
once. Alternatively, the "window editor" can be used. The 
window editor, invoked by “Z°W, puts up a display of the numbers, 
positions, sizes, and contents of all extant windows, and allows 
destruction, selection, and size-adjustment of windows by 
positioning to the line describing the window to be dealt with 
and issuing requests. 
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ADDING WINDOWS 


*X2 


The “X2 request, create-new-window-and-go-there, creates a 
new window at the bottom of the screen, and selects that window. 
The window sizes adjust so that all windows are the same size. 
The buffer placed on display in the new window is one whose name 
is constructed as "Window ## Default" (where ## is the window 
number, the top one being window 1). Thus, if you issue “*X2 when 
you have only one window, the second window displays a buffer 
named "Window 2 Default." No arguments are accepted by “X2. 


“X3 


The “X35 request, create-new-window-and-stay—here, creates a 
new window at the bottom of the screen, but keeps the currently 
selected window selected. The name of the buffer placed in that 
window is constructed as described above. The new window becomes 
the LRU window, so a “X4 request selects the window created by 
“X3 if it is not used before the “X4 is issued (see “X4, below). 


REMOVING WINDOWS 


*X1 


The “X1 request, expand-window-to-whole-screen, removes all 
windows except the currently selected window, which then grows to 
occupy the whole screen. Removing a window does not mean getting 
rid of the text or buffer that is on display in that window; it 
just means taking the window off the screen. 


“XO 


The “XO request (control x zero), remove-window, removes the 
selected window from the screen, giving the space it occupied to 
the windows that were on either side of it. The previous window 
becomes the new selected window. With a positive numeric 
argument, removes the window specified, where the topmost window 
is 1. 


SELECTING A WINDOW 


“XO 


The “XO request (control x "oh"), select-other-window, 
selects the previous window, which is the window you were last in 
before you were in this window. With only two windows, XO 
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selects the "other" window. The cursor appears at the point 
where it last was in this window. Note that the window in which 
you issue the “XO now becomes the previous window, so successive 
“XOs switch windows back and forth. Selecting a window, of 
course, may potentially (and usually does) switch buffers, too. 
The mode line always tells you what buffer is current; the cursor 
tells you what window is selected. 


“X4 


The “X4 request, select-another-window, selects the LRU 
window. With a positive numeric argument, e.g., ESC 3 “X4, it 
selects the specified window (window 3, in this case). The 
topmost window is window 1. 


A good use for this request with no numeric argument is to 
select a window you have not been using much (hence, its LRU 
status) whose contents you can therefore afford to overwrite for 
some other purpose, such as “XB or “X"F. Selecting the LRU 
window makes it the most recently used (i.e., selected) window. 
So some other window is now LRU, and another “X4 selects that 
window. Thus, successive “X4's (or “X4 “Cc “*C ...) cycles 
through all windows on the screen. 





KDITING WITH MULTIPLE WINDOWS 


The standard Emacs requests work in their usual fashion when 
you are editing with more than one window. You can edit the 
material in one window, switch to another (via “XO, “X4, and some 
requests provided by the window and buffer editors described 
below), and edit the material there. You can, however, only edit 
in one window at atime. While you are editing the material in 
that window, you frequently refer to the display(s) in the other 
window(s). If you need to see more of the buffers displayed in 
the other windows, switching to them simply to display another 
set of lines, and then switching back, is very inconvenient. 
This is especially true if you are using several windows, so that 
each portion displayed is relatively small. The ESC “V request 
solves this problem. 


ESC “V 


If you want to "turn the pages" in the windows that are not 
selected, you can do so without switching to then. The ESC “V 
request, page-other-window, is only valid when more than one 
window exists. Without a numeric argument, ESC “V displays the 
next windowful (as with a “V) of the "other" window. The other 
window is the unselected window when only two windows exist; when 
more than two exist, the other window is the next most recently 
used window. With a positive numeric argument, e.g., “U ESC “V, 
this request goes forward the specified number of screensful (4 
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in this case) and displays it. With a negative numeric argument, 
it pages the other window backward the specified number of 
screensful. 


The ESC “V request is, of course, most useful if you need to 
refer frequently only to one other window (if you are, for 
example, responding to mail). If you have to update several 
windows, however, you must switch windows. Use “X4 to go to 
whichever window(s) you want, then use “V or ESC V as usual, and 
return to the original windows with “X4. 


One word of warning with multiple-window editing: if you 
display the same buffer in more than one window at once, Emacs 
becomes slower, less efficient, and substantially more expensive 
to use while the buffer is so displayed. Avoid entering text 
into such a buffer if any of these issues are a concern. 


DEDICATED BUFFERS © 


yveveral Emacs requests always switch you into a new buffer 
dedicated to their exclusive use, and leave you in that buffer. 
The window editor (°Z°W), thé comout-command request (XE) 
described in Section 17, which allows you to execute a ees 
command and displays the output of that command in 
"file output" buffer, and the Emacs mail requests (“XM and “xR) 
described in Appendix B, are all examples of requests requiring 
their own buffers. These requests are often issued while you are 
in the midst of editing, and you generally do not want them to 
obliterate your work from the screen. Thus, when you use any of 
them, you probably want at least one extra window available. The 
“X2 or “X3 request is a good way to get the extra window. 


some dedicated-buffer requests select the window that 
already contains their appropriate buffer (e.g., “X°E selects 
"file output" if it is on display in any window). If the 
appropriate buffer does not exist, they either select the LRU 
window, replacing that window's previous contents with their 
display, or they use the current window for their display. The 
choice of LRU or current window depends on the request. The 
“X°E, “XM, and “XR requests choose the LRU window, but “Z*W 
chooses the current window. To make a window available without 
endangering any windows already in use, use “X2 for those 
dedicated-buffer requests utilizing the current window, and “X3 
for those utilizing the LRU window. This process of selecting 
the window with the appropriate buffer is called 
find-buffer-in-window (and is available to programmers writing 
extensions. See the Extension Writers' Guide) 
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THE WINDOW EDITOR 


“O° W + 2 


The window editor provides an interactive way to manipulate 
windows, allowing you to reorganize the screen conveniently. The 
window editor puts a formatted display in a dedicated buffer. 
The display appears on the screen in the selected window (the 
window where the cursor is currently sitting). The window editor 
buffer is named WINDOWSTAT. If you want WINDOWSTAT to appear in 
a window other than the current one, issue “Z2°W with a numeric 
argument, e.g., “U°Z°W. If WINDOWSTAT is already displayed in 
another window, the new display appears there; otherwise, the new 
display appears in the LRU window. 


term-paper appear on 
WINDOWSTAT 2* 


Messages from COMSAT 





Hach line relates to the contents of one window on the screen at 

the time the window editor was entered. There are as many lines 

as there are windows. You cannot use standard Emacs requests to 
change the contents of the display; it is read-only. You can, 
however, use standard Emacs requests (e.g., search requests, aos 
etc.) to position the cursor in it. The cursor, when in the 2. 
window editor's buffer, is always on some line of the buffer (the 
buffer may be larger than the window it is in, like most Emacs 
buffers). That line relates to one of the windows; the window's 
window-number from the top of the screen is the first number on 

that line. The window designated by the line on which the cursor 

is will be called the "designated window" (do not confuse this 

with the selected window, which is the window containing the 
Window editor's display while you are working in the window 
editor). 


The window number followed by a star shows which window was 
the selected window at the time the window editor was entered. 
The next number on each line is called the internal window 
number, and is usually not of interest. The remaining two 
numbers on each line are the position and size of each window. 
The position is the screen's line number at which the window 
starts (the screen's top line is 0). The size is the number of 
lines in the window. 
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Following the position and size is the buffer name of the 
buffer currently on display in that window. Following the buffer 
name are the first ten characters of the point line in that 
window. The point line is the line in the window that the cursor 
goes to if that window is selected (generally the line where the 
cursor last was in that window). 








Window Editor Requests 


You operate the window editor by invoking it, positioning to 
some line, thus designating some window, and issuing window 
editor requests to affect that window. The following requests 
are recognized (note that they are printing characters, instead 
of control characters, for ease of typing, since you cannot enter 
text into a read-only buffer). 


8 
Goes to (selects) the designated window, leaving the 
window editor, and moving the cursor to this window. 


Goes to the designated window (same as g, for 
compatibility with the buffer editor). 


Kills (removes) the designated window from the screen. 
This is done immediately, and the buffer editor display 
is updated to reflect the new screen layout. The space 
occupied by this window is distributed among its 
neighbors. 


Kills the designated window (same as =k, for 
compatibility with the directory editor. See “XD in 
Section 17 for information on the directory editor). 


(caret) 

Moves the the topline of the designated window up one 
line, increasing its size, and deducting one line from 
its neighbor above. With a numeric argument, moves up 
that many lines instead of one. The buffer editor 
display is updated to reflect the new screen layout. 
(The shapes of the ~, V, A, and U requests suggest 
their function.) | 


Moves the bottomline of the designated window down, 
same rules and features as ~ 


Moves the topline of the designated window down, same 
rules and features as ~* 
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Moves the bottomline of the designated window up, same 
rules and features as ~ 


The following requests do not deal with the designated 
window, and can be issued at any time in the window editor: 


n 
Goes to the next line of the window editor display. 
You could use “N as always, but n is easier ina 
read-only buffer. If on the last line, goes to the 
first. 


Goes to the previous line. If on the first line, goes 
to the last. 


Exits the window editor by entering the buffer editor 
in the window now occupied by the window editor's 
display. 


Creates a new window (like “°X3), and leaves you in the 
window editor's display. The display is updated to 
reflect the new state of the screen, with the new 
window as designated window. 


Creates a new window (same as c, for mnemonic ease with 


a Oa 


LEAVING THE WINDOW EDITOR 


The window editor is usually exited by selecting some other 
window with the g request; indeed, you may often enter the window 
editor for no other reason than to do this. You can also exit 
via the b request to the buffer editor, or just issue a “XB or 
“Xx°F to go elsewhere. Window editor windows left on the screen 
after you exit the window editor are not updated dynamically by 
Emacs when windows and buffers are changed around. 


THE BUPFPER EDITOR 


The buffer editor, provides a facility for deleting, 
examining, and selecting buffers, similar to the window editor. 
The buffer editor creates a read-only display in a dedicated 
buffer. The display appears on your screen in the selected 
window. As with the window editor, several buffer editor 
requests, invoked by typing selected printing characters, allow 
you to manipulate the buffer designated by the cursor's position 
in the display. 
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The buffer editor is entered via “Z*B. It puts its display, 
a buffer named BUFED, in the window in which it was invoked. If 
you do not want to overwrite the selected window, issue “Z°B with 
a numeric argument, e.g., “U°Z"B. The buffer editor's display 
then appears in the window already displaying it, if one exists; 
otherwise, it appears in the LRU window. 


Each line of the buffer editor's display contains a buffer's 
name, a pathname if the buffer has a pathname associated with it, 


and, possibly, flags. The flags appear at the left margin, and 
they are: 


bal This buffer is modified (needs writing out). 

> This buffer was current when the buffer editor was 
entered. 

x This buffer is marked for deletion by the buffer 
editor. 


There may be more buffers (i.e., lines in the buffer 
editor's display) than are on display in the window in which this 
display appears; like any other Emacs buffer on display, “V, ESC 
V, or any other standard Emacs request can be used to position 
the cursor in it. 


Buffers can be killed (as “XK does) with the buffer editor k 
or d request. Buffers so killed are not actually destroyed until 
the buffer editor is exited via ag, w, f, q (or “X°Q) request, 
at which time you are asked if you really want to delete them 
(they are listed in a local display). 


Buffer Editor Requests 


The following requests are known to the buffer editor: 


n 
Goes to the next line, or the first line if now on the 
last. 

Pp ° ° 
Goes to the previous line, or the last line if now on 
the first line. 

k 
Marks the designated buffer for deletion when the 
buffer editor is exited and moves to the next line. 

d 


Marks the designated buffer for deletion (same as k, 
for compatibility with the directory editor). 
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Writes the designated buffer out to its default 


pathname (it must have one). This marks it as 
unmodified. 


Undoes the effects of k or don the designated buffer, 
i.e., unmarks it. The X flag is removed from the 
display, and the cursor is positioned to the next line. 


Examines the designated buffer. In one-window mode, 
you Should just go there. With two or more windows, 
Emacs selects a window via find-buffer-in-window for 
the designated buffer, putting it on display if not 
already on display. A message is printed in the 
minibuffer about where (in what window) it appears. 


LEAVING THE BUFFER EDITOR 


These next requests cause the buffer editor to be exited; 
you are queried about pending deletions if you have any: 


& 


Goes to the designated buffer, exiting the buffer 
editor, replacing its display in the current (selected) 
window, with this buffer. This is just like doing a 
XB As a matter of fact, the buffer editor can be 
used for just seeing what buffers there are and going 
to one, to save typing. This is especially useful for 
buffers with long and complex names, like "Messages 
from Brzezinski." 


selects a window and displays the designated buffer via 
find-buffer-in-window. Since the buffer editor makes 
its own window LRU when it exits, if you "f" a buffer 
not currently on display in any window, it is the same 
as going to it via the g request, replacing the buffer 
editor's window. 


However, if the designated buffer is on the screen 
somewhere, the cursor simply moves into that window 
(and thus, into that buffer). If you use multiple 
windows, you will find that you use "f" all the time, 
and rarely use "g". 


Exits the buffer editor by entering the window editor 
in the window now occupied by the buffer editor's 
display. 
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Exits the buffer editor and enters, in the current 
window, the buffer from which it was invoked by “Z*B. 
If you invoked the buffer editor with a numeric 
argument, e.g., “U°Z°B, this exits the buffer editor 
and enters, in the appropriate window, the buffer from 
which you invoked it. 


Exits the buffer editor in the same manner as with "q." 
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SECTION 17 


SUMMARY OF EMACS FUNDAMENTAL MODE REQUESTS 


The following requests have been grouped according to the 
functions they perform. They are the requests available in 
Fundamental mode, which is the default mode entered in new 
buffers. Some may appear more than once if they serve more than 
one purpose. To invoke the extended requests, type an ESC X 
followed by the command name. If the extended request requires 
an argument, type it after the command name (with a space 
separating the two). Then, with or without argument(s), type a 
carriage return. The following is alist of the functions and 
the requests (by key) documented within each group. After this 
list, full descriptions of each request in each of the groups are 
given. 


LIST OF EDITING FUNCTIONS AND THE KEYS THAT PERFORM THEM 


ee ere crc eee eee ee 


“B “FP “A “RE 
“NW “p ESC B ESC F 
ESC A ESC E ESc [ ESC | 
a ESC V ESC < ESC > 
ESC G ESC “*B ESC “F 
Deletion 
# \177 “D @ 
oi ESC # ESC \177 ESC D 
“W eee: "KAT? ESC K 
“XK ESC “W ESC “Y exo 
“Zs 
Retrievals/Yanks 
a ESC Y ESC “*Y 
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Marks, Regions, 
“@ 
“Z°@ 
i Gaal 
ESC X 


Variables 


ESC #H 

“2G 

“xk U 
lvars 


searches and Substitutions 


“R 

“XS 

ESC X 
Files 

“XR 
Insertion 

“XI 


Entry and Exit 
eA 
“XD 

Help 
Esc ? 
ESC X 
Bsc X 
BSC X 


Error Recovery 
“G 
New Lines/Blank 


CR 


Indentation and 


ESC \ 
ESC I 


A 


ESC &% 
replace 


“XCR 


apropos 
describe 


ESC / 


make-wall-chart 


White Space 


ESC M 
ESC CR 


“xX *X 
ESC W 
“XG 


ESC °G 


ESC “O 


“XF 
ESC ~* 


oo 7 * 
: 4 
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Pa 
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Comments 


oe Boy. 3 “Z3 HSC N 
ESC P 
ESC X set-comment—-prefix 


Formatting 
hes pa ESC S BSC Q 
ESC X fillon 
ESC X filloff 
ESC X runoff~fill-region 


Literal Character Entry 
\ *Q 


special Purpose Keys 


7 aay “U ESC 
“XESC ESC X 

Macros 
“xX ( “a “Xx* “XE 
“XQ 


ESC X save-macro 
ESC X edit-macros 
ESC X show-macro 


Characters (Moving by/Deleting) 


“B “P ft \177 
1) 


Lines (Moving in and by/Deleting) 


“A “= “N “Pp 
“X= ESC G @ | “K 

Words 
ESC B ESC F ESC # ESC \177 
Bsc D EXC C ESC L ESC U 
BOC oD 
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Sentences 


ESC A 

ESC K 
Paragraphs 

Esc [ 
screens 

“V 

se Aas 
Buffers 

ESC < 

“XH 


Multiple Windows 


“XO 


Mail/Messages 
“XM 


ESC E “X# “XN 77 
ESC ] ESC H 

ESC V “L ESC R 
ESC > “XB “xX *B 
“XK ESC ~ o7 3 
ee “X2 “X3 

abd 8 ESC “V a7 WN 
“XR 


ESC X accept-msgs 


Typing Shortcuts 


ae 

ESC X 
ESC X 
HSC X 


“D “U 
setab 
speedtype 
speedtypeoff 


Programming Modes 


ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 


PS 


Pq Pd PS Pd PS PS PS PS 


alm—-mode 
electric-—pli-mode 
fortran-mode 
fundamental-mode 
lisp-mode 

pli-mode 
set-compile-options 
set-compiler 

ldebug 
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Printing Terminal Usage 


os, a 
7 ‘. 
5 


“XV 


Extension Writing 


ESC ESC 

ESC X ldebug 
ESC X loadfile 
ESC X loadlib 


Additional Optional Settings 


DESCRIPTIONS OF 


« =e 

wet 
( <o 
at 


yates 


“B 


ESC 
ESC 
ESC 
BSC 
HSC 
ESC 
ESC 
BSC 
BSC 


P< Pd PS PS PS PS PS PS PS 


opt 

option 
set-minibuffer-size 
reset-minibuffer-size 
set-screen-size 
reset~screen-size 
set-key 
set-permanent—key 
set-search-mode 


THE REQUESTS 


Movements Forward/Backward 


backward-char 


Moves backward one character in the buffer. 
the newline characters at the 
one character. 


the 


argument; moves forward and repeats 


buffer. Repeats 


numeric argument. 


forward—-char 


Moves forward one character. 
as one character each. 


the 


argument; moves backward and 


buffer. Repeats 


numeric argument. 


go-to-—beginning-of—line 


Positions to the beginning of the current line of the 
buffer, i.e., right before the first character. 


go-to-end-of—-line 


Positions to the end of the current line, 


the last character and before the 
empty line, this is the 
line. 


ends of lines count as 
Beeps as for G at the beginning of 


with a negative 


Tabs and newlines count 
Beeps as for “G at the end of 


repeats with a negative 


Same as the beginning of the 


N next-line-—command 

Positions to the next line of the buffer. If on the 
last line, appends a new empty line to the bottom of 
the buffer, and positions to the beginning (and end) 
of 1h Successive “Ns and “Ps try to maintain the 
same horizontal position. Repeats with a positive 
numeric argument; performs “Ps and repeats with a 
negative numeric argument. 


“Pp prev-line-command 
Moves to previous line of the buffer. Beeps as for 
“G if on first line of the buffer. Attempts to 
maintain the same horizontal position; successive 
“P's and “N's try to maintain the original horizontal 
position. Repeats with a positive numeric argument; 
moves to next line and repeats with a negative 
numeric argument. 





ESC B backward-word 
Goes backward one word. If in the middle of a word, 
goes to before the beginning of that word. Skips 
backward over all white space to get to the next 
word. Underscores and backspaces count as parts of 


words. Repeats with a positive numeric argument; 
goes forward and repeats with a negative numeric 
argument. , 


ESC F forward-word 

Goes forward one word. If in the middle of a word, 
moves to the end of the current word. Leaves point 
immediately after that word. Passes over all 
punctuation and white Space before the word. 
Underscores and backspaces count as parts of words. 
Repeats with a positive numeric argument; moves 
backward and repeats with a negative numeric 
argument. 


HSC A backward-sentence 
Goes to the beginning of the current sentence, i-.e., 
just before the first letter. If already at the 
beginning of a sentence, goes to the beginning of the 


previous sentence. The beginning of the first word 
after a blank line always counts as the beginning of 
a sentence. Repeats with a positive numeric 


argument; goes forward and repeats with a negative 
numeric argument. 


ESC E forward-sentence 
Moves forward to the end of this sentence. If at the 
end of a sentence, moves forward to the end of the 
next sentence. Ends of paragraphs are implicitly 
ends of sentences, whether or not an end~of-sentence 
punctuation (period, question mark, exclamation 
point) appears. Repeats with a positive numeric 
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ESC | 


ESC V 


ESC < 


ESC > 
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argument; moves backward and repeats with a negative 
numeric argument. 


beginning-of-paragraph 

Moves to the beginning of the current paragraph. If 
already at the beginning of a paragraph, moves to the 
beginning of the previous paragraph. The beginning 
of a paragraph is the beginning of the first line of 
the paragraph. The definition of paragraphs is 
controlled by the paragraph-definition-type option: 
if 1, blank lines separate paragraphs; if 2, an 
indented line starts a paragraph. The Multics runoff 
or compose command's control lines count as 
individual paragraphs. Repeats with a positive 
numeric argument; moves forward and repeats with a 
negative numeric argument. 


end-of—paragraph 

Moves to the end of the current paragraph. If at the 
end of a paragraph, moves to the end of the next 
paragraph. The end of a paragraph is the end of the 
last line of the paragraph. The definition of 
paragraphs is controlled by the 
paragraph-definition-type option: if 1, blank lines 
separate paragraphs; if 2, an indented line starts a 
paragraph. The Multics runoff or compose command's 
control lines count as paragraphs. Repeats with a 
positive numeric argument; moves backward and repeats 
with a negative numeric argument. 


next-screen 

Displays next screenful of the current buffer. 
Leaves cursor at upper left hand corner of screen. 
With a positive numeric argument, pages forward the 
specified number of screensful and displays it; with 
a negative numeric argument, moves backward the 
specified number of screensful (previous screens) and 
displays it. 


prev-screen : 

Displays the previous screen (one back) of this 
buffer, leaving cursor at the top of it. With a 
positive numeric argument, moves backward the 
specified number of screensful and displays it; with 
a negative numeric argument, moves forward the 
specified number of screensful and displays it. 


go-to-beginning-of—buffer 

Moves to the beginning of the current buffer, i.e., 
before the first character in the buffer at the top 
of the document being edited. 


go-to-end-of—buffer 


Moves to the end of the current buffer, i.e., before 
the newline on the last line of the current buffer at 
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ESC 


ESC 


KSC 


Deletion 


if 


the bottom of the document being edited. You cannot 
position beyond that newline. 


go-to-lLine—number 
Goes to a given line, specified by line number, from 
the top of the buffer. The positive numeric argument 
specifies the line number. For instance, ESC 25 ESC 
G goes to line 25. 


balance-parens-—backward 

Skips backward over one set of balanced parentheses. 
yearches backward until a set of parentheses is 
found. Does not handle quoting or any programming 
language conventions. 


balance-parens—forward 

Skips forward over one set of balanced parentheses. 
Searches forward until a set of parentheses is found. 
Does not handle quoting, or any other programming 
language conventions. 


rubout—char 

Deletes the previous character (before the cursor, 
which is usually the last character typed). Note 
that # deletes the character to the left of the 
cursor, while “D deletes the character at the cursor. 
Repeats with a positive numeric argument, deletes the 
character at the cursor and repeats with a negative 
numeric argument. 


\177 (delete key)  rubout-char 


Deletes the previous character (before the cursor, 
which is usually the last character typed). Note 
that \177 deletes the character to the left of the 
cursor, while “D deletes the character at the cursor. 
Repeats with a positive numeric argument; deletes the 
character at the cursor and repeats with a negative 
numeric argument. 


delete~—char 

Deletes the character to the right of the current 
point. This is the character on which the cursor 
sits. Moves the rest of the line one to the left, 
closing up the space. Deleting a newline at the end 
of a line merges lines. Repeats with a positive 
numeric argument; deletes the previous character and 
repeats with a negative numeric argument. 


kill-to-beginning-of-—line 
Kills all the text to the left of the cursor on the 
current line. The killed text is saved on the kill 


ring, and may be retrieved with “Y. 
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kill-lines 

Kills to end of line; when already at end of line, 
deletes the linefeed (merges eee If on an empty 
Line, deletes it. If given a positive numeric 
argument, deletes that many lines, starting from the 
current point on the current line. Successive “Ks 
merge killed text on the kill ring. 


rubout-word 

Deletes the word to the left of the current point. 
More specifically, deletes going hackward, deleting 
characters until the beginning of a word. Successive 
words deleted with ESC # are merged and can be 
retrieved with one “Y. Repeats with a positive 
numeric argument; deletes forward and repeats with a 
negative numeric argument. 


ESC \177 rubout-—word 


BSC D 


oe. ier 


Deletes the word to the left of the current point. 
More specifically, deletes going backward, deleting 
characters until the beginning of a word. With a 
positive numeric argument, deletes the specified 
number of words. Deletes forward the specified 
number of words with a negative numeric argument. 
Successive words deleted with ESC \177 are merged and 
may be retrieved with one “Y. 


delete-word 

Deletes the word to the right of the current point. 
More specifically, deletes forward, deleting all 
white space and punctuation and characters until the 
end of the next word. Repeats with a positive 
numeric argument; deletes backward and repeats with a 
negative numeric argument. 


wipe-region 

Wipes (kills) all text between cursor and the mark. 
Does not participate in kill merging i.e., successive 
“Ws do not merge text on the kill ring. The killed 
text is saved on the kill ring, and can be retrieved 
with “Y. 


kill-backward-sentence 

Kills backward to the beginning of this sentence; 
kills as much of the sentence as thus far typed. 
Successive kills via “X# and other reverse-killing 
requests (e.g., ESC #) merge, and may be retrieved 
with one ‘Y. Repeats with a positive numeric 


argument; kills forward and repeats with a negative 
numeric argument. 


kill-backward-sentence 

Kills backward to the beginning of this sentence; 
kills as much of the sentence as thus far typed. 
Successive kills via *X\177 and other reverse-killing 
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commands (e.g., ESC #) merge, and may be retrieved 
with «one “Y. Repeats with a positive numeric 
argument; kills forward and repeats with a negative 
numeric argument. 


kill-to-—end-of-sentence 

Deletes text going forward from the cursor to the end 
of the current sentence. If at the end of a 
sentence, deletes forward to the end of the next 
sentence. Sentences and other text killed 
consecutively in this fashion are merged, and may be 
retrieved with a single “Y. With a positive numeric 
argument, kills the specified number of sentences. 
Kills backward the specified number of sentences with 
a negative numeric argument. 


kill-buffer Kills (destroys) a buffer. Prompts for 
the buffer's name, terminated by CR. A response of 
CR kills the current buffer. Buffers can be killed 
to conserve storage, to prevent their appearance in 
buffer listings, or to prevent being queried when 
quitting with “x°C. 


merge—-last—kills-with-next 

Causes the next kill-type request (e.g., “K, ESC D), 
which must follow immediately, to merge what it kills 
with the last saved kill on the kill ring, in the 
same direction as the next request kills. For 
instance, “A “K “*K “N *N ESC *W K “°K eatenates two 
disjoint Lines on the kill ring. 


yank-minibuf 

Yanks back the last contents of the minibuffer, 
without a prompt string. The mark is set in the 
minibuffer, so “X°X can be used to position around 
it, and “W to delete it. The real mark in the main 
buffer is not destroyed. 


delete-—blank-—lines | 
Deletes blank lines around cursor: gets rid of 
vertical white space. If issued ona blank line, 
leaves one blank line; otherwise, deletes all blank 
lines after this line's end. See “O. 


kill-comment 

Removes the comment and the white space preceding it 
from the current line. The deleted text is saved on 
the kill ring, accessible to “Y. The text is saved 
in such a way that following “Ks and other 
forward-killing requests merge properly with the 
deleted text. 
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Retrievals/Yanks 


“y, 


ESC Y 


ESC “Y 


yank 


Yanks (retrieves) killed text into place at cursor. 
Retrieves last killed word, line, or region. Witha 
positive numeric argument, goes that many killings 
down the 10-position kill ring. Leaves the mark at 
the front of the retrieved text, and the point at the 
end. 


wipe-this—and-yank-previous 

Deletes the text between the point and the mark 
without saving it, rotates the kill ring one position 
(slot 2 text now occupies slot 1), and retrieves the 
text just moved to the first slot of the kill ring. 


yank-minibuf 

Yanks back the last contents of the minibuffer, 
without a prompt string. The mark is set in the 
minibuffer, so “X°X can be used to position around 
it, and “W to delete it. The real mark in the main 
buffer is not destroyed. 


Marks, Regions, Variables 


“@ 


ESC H 


set-or-pop-the-mark 

With no argument, sets the mark in this buffer where 
the cursor is now, and leaves it there. The current 
value of the mark, if any, and if different from the 
current point, is pushed on to the mark ring. The 
mark relocates to the nearest point if the text 
around it is deleted. See “X*X to verify where the 
mark is. With a positive numeric argument, e.g., “U 
“@, pops a mark off the mark ring, and positions to 
it. Successive “U “@s "try" all marks on the mark 
ring. 


mark-paragraph 

Puts the mark at the beginning of the current 
paragraph; puts the cursor at the end of the current 
paragraph. See ESC [ for a definition of paragraphs. 


mark-whole-buffer 

Puts the mark at the end of the buffer and the cursor 
at the beginning. This "marks" the whole buffer, so 
that “W deletes it, etc. The linefeed at the end of 
the buffer is not in the marked region, but “XH “W 
“XB... “Y effectively moves a whole buffer. 


exchange-point-—and-mark 

Exchanges the cursor and the mark, to verify their 
positions before typing “W or similar requests. Puts 
the cursor where the mark is and vice versa. Typing 
“K°X X°X quickly verifies the extent of the 
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point/mark region visually and returns the cursor and 
mark to their original positions. Use “@ with a 
positive numeric argument (e.g., “U°@) to visit older 
settings of the mark in this buffer. 


set-named-mark 

Prompts for a name to be associated with a mark, and 
sets that named mark to be where the cursor is now. 
Named marks are valid only in the buffer in which 
they were created. Use “ZG to go to a named mark. 


go-to-named-mark 

Prompts for the name of a named mark, and moves the 
cursor to the point where that mark was saved. Use 
“Z°@ to set a named mark. 


wipe-region 

Wipes kill merging i.e., successive “Ws do not merge 
text on the kill ring. The killed text is saved on 
the kill ring, and can be retrieved with “Y. 


copy~region 

Copies the text between the cursor and the mark on to 
the top of the kill ring. This means that the next 
“Y eopies the text now between the cursor and the 
mark to wherever the cursor is when the “Y is issued. 


Llower=case-region 
Lowercases all letters between seint and the mark. 


Uppercases all letters between point and the mark. 


put-variable 

Stores away point/mark region to a variable, whose 
name is prompted for, terminated by CR. Use “XG to 
retrieve this value, and ESC X lvars' to list such 
variables. 


get-variable 

Gets back a variable stored by “XX. The name of the 
variable is prompted for; the cursor is put after it, 
and the mark before it. 


lvars 

Displays the names and lengths of ee variables saved 
by “XX. Type “J to resume, or just continue editing. 
See “XX and “XG. 


Searches and Substitutions 


reverse-~string-search 
Reverse searches. Leaves cursor positioned before 
matching string; does not move cursor if not found. 
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Esc / 


“XW 


Prompts for search string in minibuffer, which must 
be ended with OCR. 


string-search 

searches for a character string, from current point 
in buffer to end. Prompts for search string in 
minibuffer, and leaves point, if search succeeds, 
after the matched string. End search string with CR. 
Typing “S CR reuses last search string. If search 
fails, point does not move. 


regexp-search~command 

searches forward for a regular expression that is 
prompted for and terminated by OR. A regular 
expression is a character string in which the 
following special characters can be included: 


% 


matches any number, including none, of the 
character preceding it. 


matches any character (*. matches everything). 


represents an imaginary character preceding the 
first character on a line (this character is the 
caret, not the representation for the control 
key). It must be the first character ina 
regular expression; its use allows you to search 
for the line beginning with the next characters. 


represents an imaginary character following the 
last character ona line. It must be the last 
character in a regulan expression; its use 
allows you to search for a line ending with the 
preceding characters. 


To include any of these special characters in 
the regular expression without their special 
meaning, you must precede each occurrence of 
them with \c. 


Searches forward from cursor, and can find many 
occurrences of the regular expression on-.one 
line. Leaves the cursor and the mark around the 
string it finds, so that: 


s/(fo.*)/(a b & )/ (qedx) 
is equivalent to: 
ESC / (fo.*)CR *W (a b “Y ) (Emacs) 


multi-~word-search 
searches for words. Prompts for one or more words, 
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terminated by CR. (This is a search string; typing 
just a CR in response to the prompt reuses the last 
search string). searches from current point to the 
buffer's end for those words appearing in order, 
regardless of case of letters, underlining, 
intervening punctuation, white space, or line breaks. 
Finds whole words, not parts of words. A partial 
word ending with * in the search string is matched by 
any word beginning with the letters provided. With a 
positive numeric argument, e.g., “U°XW, goes to 
beginning of buffer before searching. 


global—print—command 
Prints all lines containing a given string. Prompts 


for the string , terminated by CR. With a positive 


numeric argument, e.g., “U°XS, takes a regular 
expression, i.e., the search string can include the 
special characters *, ., $, and ~ (not the control 


key, but the caret symbol). See ESC / for the 
meanings of these special characters in a regular 
expression. Type “J or continue editing to restore 
buffer display. 


query-replace 
Interactively replaces all occurrences of one string 


with another. The request prompts for both strings | 


in the minibuffer, terminated by CR, and then 
searches forward for each occurrence of the first 
string. It positions the cursor immediately after 
this string and waits for one of the following 
responses (type the appropriate keys): 


Space 
replaces this particular occurrence of the first 
string with the second. Then searches for the 
next occurrence of the first string and waits 
for a response again. 


CR 
leaves this occurrence of the first string alone 
and searches for the next occurrence of the 
first string. 

(period) } 
replaces this occurrence of the first string 
with the second and then terminates the query 
replace. 

“G 
terminates the query replace without modifying 
this occurrence of the first string. 

replace 


Globally replaces one string with another, from the 
current point to the end of the buffer. Prompts for 
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two strings, terminated by CR. If the first string 
is not found, ESC X replace does not prompt for the 
second string, and does not move the cursor. Use ESC 
% if you want to be queried before each replacement 
occurs. 


find-file 

Reads in a file. Prompts for a file's pathname, 
terminated by CR. This request attempts to switch to 
a buffer (see “XB) that contains the specified file. 


If no such buffer exists, “X°F reads the file into 
the buffer whose name is the first component of the 
entry portion of the filename, and sets the default 
file of this buffer to the file just read. If the 
find-file-set-modes option is on, “X"F sets the major 
mode of the buffer according to the last component of 
the entry portion of the filename. For example, for 
the filename "Dldd>include>sst.incl.pli", the buffer 
chosen is "sst" and the major mode is "PL/I." 


If one or more such buffers exist, they are listed as 
if by “X°B. You are then prompted for the name of 
the buffer you wish to use, terminated by CR. If the 
buffer specified is one of those listed, “X°F 
Switches to it. If a new buffer name is specified, 
“X°F reads the file into that buffer as described 
above. A blank response for the buffer name uses the 
original buffer named by the first component of the 
entry portion of the filename. 


read—file 

Reads in a file. Prompts for a file's pathname, 
terminated by CR. Reads that file into the current 
buffer, destroying anything which was in the buffer, 
and sets this buffer's default file to the file read. 
The cursor is left at the first position of the first 
line of the file read. If a blank response is given 
for the filename, the buffer's default file is read. 
The default file is set by “X°R, “X°F, and “X°W. 
This is useful for starting again after big mistakes. 


save-same-file 

Writes out the buffer contents to the same file last 
read in or written out, i.e., writes the buffer to 
its default file. This request is equivalent to 
“X “WOR. 


write-file 
Writes the current buffer out to a file, whose 
pathname is prompted for in the minibuffer, 


terminated by CR. If a blank or null response is 
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given, writes it out to this pbuffer's default file. 
The file specified becomes the buffer's default file. 
See “X’°S. 


Insertion 


“XI insert-file 

Inserts a file into the current buffer. Prompts for 
a file's pathname, terminated by CR. Reads that file 
into the current buffer without destroying the 
previous contents of the buffer. The file is read in 
to the left of the cursor and the cursor is left 
after the contents of the file just read. The 
ay file for the buffer is not changed. (See 
"hk Bs 


“Z°F get-filename 
Inserts the pathname (as seen in the buffer's mode 
line) of the current buffer at the cursor. 


Entry and Exit 


“X*C = =quit-the-editor | 
Exits the editor. If modified buffers exist, they 
are listed as if by “X°B; “X°C then asks you if you 
really want to exit the editor. : 2 


“XCR eval-multics—command-line 
Prompts for a Multics command line, terminated with 
CR, and executes it. Multics commands that produce 
output may well ruin your screen; if this occurs, use 
“L. If you expect output, use “X*E instead of “XCR. 
A “X°M is equivalent to “XCR. 


“xX*E comout-command 
Executes a Multics command line (prompted for, end 
with CR), and displays the command line's output in 
Dulter "fi Le Out puGs * if butter “file output™ is 
already on display in a window, the cursor moves to 
that window, and "file output" stays there. 


“Z°Z signalquit 
Signals QUIT to Multics and clears the screen. 
Restores the tty modes suitable for Multics command 
usage before doing so, and after you type start, it 
restores the appropriate tty modes for the Emacs 
environment. 


“XD edit-—dir 
Enters the directory editor, editing the working 


directory. With a positive numeric argument, e.g., ant 
“U°XD, prompts for some other directory name. i) 
Position to a line with some segment's name on it, a 
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and the following requests (keys) can be used 
(lowercase is acceptable): 


D 
Deletes this segment when directory editor is 
exited. 

U 
Undeletes, i.e., cancels previous D on this 
line. 

1 
Examines (i.e., takes a look at) this segment, 
in a separate buffer. Use “X°Q to get back, and 
the examine buffer disappears automatically. 

Q 
Quits the directory editor. A list of files is 
shown, and you are queried if you want to delete 
them or not. To exit without any action, use 
Oe 

N a 
pame as N. 

Pe 
Same as “P. 

describe-key 


Displays the documentation for a given key sequence. 
For example, to find out what a “D does, type ESC ? 
and, when prompted, a “D. With a positive numeric 
argument, e.g., -U ESC ?, displays in the minibuffer 
just the command name to which’ the key is currently 
connected. 


help-on-tap 
Gets help/documentation at any time. The current 
repertoire is: 
a: 
Shows where to get more help. 
oe 
Displays the current repertoire of “_. 
me 
Displays the last 50 characters typed in. 
nw i ¢ 


Does a “G as usual. 
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“A 
- Works like the ESC X apropos extended request. 


Works like the ESC X describe extended request. 


apropos <string> 
Lists all requests and extended requests that contain 
a given string in their command names, and tells 


what, if any, keys invoke them in the current buffer. 
For instance, 


ESC X apropos forw 


lists forward-word, forward-char, etc. This is the 


most common way to find a request that does something 
you are looking for. 


describe <extended-request> 

Displays the documentation for an extended request. 
The request's command name is given as the argument 
to describe. For example, 


ESC X describe apropos CR 
describes the "apropos" extended request. 


make-wall-chart 

Puts into a buffer a listing of all the currently 
defined requests, and what keys invoke them in the 
current buffer. This buffer can be dprinted for a 
convenient wall chart of Emacs requests. 


Error Recovery 
“G 


ee ee ee ERR 


command-quit 

Quits out of the current minibuffer prompt, if any, 
and rings the bell (or beeps). Can be used to exit a 
minibuffer you did not intend to get into, or just to 
tell when Emacs has "caught up." 


ignore-prefix 

Flushes a prefix character. Used when a prefix 
character such as “X is entered by accident; causes 
an audible signal to indicate that the “X°G has been 
executed. Unlike “G, ©X°G does not exit the 
minibuffer. 


ignore-prefix 

Flushes a prefix character. Used when a prefix 
character such as “Z is entered by accident; causes 
an audible signal to indicate that the “Z°G has been 
executed. Unlike “G, “2°G does not exit the 
minibuffer. 
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ignore~prefix 

Flushes a prefix character. Used when a prefix 
character such as ESC is entered by accident; causes 
an audible signal to indicate that the ESC *G has 
been executed. Unlike “G, ESC “G does not exit the 
minibuffer. 


New Lines/Blank Lines 


carriage return (CR) new-line 


ESC *O 


Indentation 


ESC \ 


ESC M 


Fe ecamemeaninaaaeaanetendatanmanenaedielameeetaenanantheteenttamedatenameanl 
cscs sey SONNE R70 SSSA GUM i pgp gp SS 


Inserts a newline character into the buffer at the 
current point, ending the current line, and starting 
a new one. If entered in the middle of a line, 
breaks the line at the current point. If the next 
line is empty, i.e., was made by a single CR or “0, 
CR just goes to it, and does not insert a newline. 
If there is a fill prefix (see “X.), CR inserts it 
after any newline character it inserts. A “Mis 
equivalent to a carriage return. 


open-space 

Opens up space by putting a newline ahead of the 
current point. Pushes all lines of the buffer below 
the current line down one. With a positive numeric 
argument, e.g., “U°U"O, opens up the specified number 
of lines (16 in this case). See “X*0 to remove 
(extra) blank lines. 


delete-blank-lines 

Deletes blank lines around cursor: gets rid of 
vertical white space. If issued ona blank line, 
leaves one blank line; otherwise, deletes all blank 
lines after this line's end. See “O. 


split-—line 
Breaks the line at this point, Shearing it 
vertically. Puts the text to the right of the cursor 
on the next line, with enough indentation so that it 
is still in the same place horizontally, i.e., the 
same column. This can be undone by “U ESC * 


and White Space 


delete-white-sides 
Deletes all white space characters on the current 
line adjacent to the character at the cursor. A 
white space character is a space, a tab, a formfeed, 
or a vertical tab. 


skip-over-indentation 


Moves the cursor to the first non-white space (i.e., 
not tab, space, formfeed, or vertical tab) position 
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on this line. In other words, skips over’ the 
indentation on this line. 


set-filil-prefix 

sets fill prefix in this buffer to be whatever is 
between the beginning of the line and the cursor 
(spaces and characters). The fill prefix is inserted 
automatically by CR, autofill, and 
runoff-fill-paragraph (ESC Q) into lines after the 
first line in the buffer. If the cursor is at the 
beginning of the line when “X. is issued, the fill 
prefix is reset (i.e., there is no fill prefix). It 
can be used to establish a left margin. 





set-fill-—column 

sets the fill column in the current buffer to be the 
horizontal position where the cursor is now. The 
fill column is the "right margin" used by ESC Q to 
fill and adjust text, by fill mode to fill and adjust 
text, and by ESC 58 to determine where to center. -The 
fill column is the first column in which text is not 
to be placed. The new value of the fill column is 
printed out in the minibuffer. If a positive numeric 
argument is given, e.g., “U 72 “XF, the fill column 
is set to that value. 


indent-relative 

Indents the current line like the previous non-blank 
line. Use for tabbing at the beginning of lines when 
building indented paragraphs, tables, etc. If the 
current line is already indented, reindents it to the 
next word on the right above the first non-blank on 
this line. With a positive numeric numeric argument, 
e.g., “U ESC I, reindents it like the last line that 
has less indentation than the current line, i.e., 
goes back up "levels" of outline, paragraph, etc. 
Thus, you can type ESC I “U ESC I on a fresh line to 
indent it one level less than the previous line. On 
a completely empty line, you can request “U ESC I 
many times to "try" different levels of indentation. 


cret-and-indent~relative 

Does a carriage return and ESC lI. Thus, if the 
current line is indented, ESC CR ends it and starts a 
new line, indented the same as the line just ended 
(the original line). If the original line is not 
indented, the new line starts under the first 
character of the second word of the original line. 
Use this request while you are typing an indented 
body of text. ESC “M is equivalent to ESC OR. 


indent-to-fill-prefix 

Deletes the indentation higeuime white space) of the 
current line, and replaces it with the fill prefix in 
this buffer, which can be set by “X.. 
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(caret, not control key) delete-line~indentation 
Deletes all white space at the beginning of this line 
and then merges it with the previous line. With a 
positive numeric argument, e.g., “U ESC", does a “N 
first, effectively connecting the next line to this 
one, without the next line's indentation. 


set-comment-column 

Sets the comment column in this buffer to the 
horizontal position where the cursor is now. With a 
positive numeric argument, sets the comment column at 
the specified column. 


indent-for-comment 

Searches for this line's comment. If one exists, 
indents it to the comment column in this buffer (see 
eee ee If one does not exist, starts one at the 
comment column on this line. Uses the comment prefix 
to search for an old one or start a new one. See 
also ESC X set-—comment-prefix. 


kill-comment 

Removes the comment and the white space preceding it 
from the current line. The deleted text is saved on 
the kill ring, accessible to “Y. The text is saved 
in such a way that following “Ks and other 
forward-killing requests merge properly with the 
deleted text. 


down-comment—line 

Properly indents the comment on the next line, or 
puts a comment on the next line if one is not there 
already. Effectively the same as “N ESC ;. See ESC 


prev-comment-—line 

Properly indents the comment of the previous line, or 
puts one on the previous line if one is not there 
already. Effectively the same as “P ESC ;. See 
Hoc. “$s 


set-comment-prefix "string" 

sets the comment prefix in. this buffer. This is 
usually set automatically by entering a major mode. 
The comment prefix is given as an argument to this 
request, in quotes. The comment prefix is used by 
ESC ;, ESC WN, and ESC P to find comments, and start 
them. 
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set-fill~prefix 

sets fill prefix in this buffer to be whatever is 
between the beginning of the line and the cursor 
(spaces and characters). The fill prefix is inserted 
automatically by CR, autofill, and 
runoff-fill-paragraph (ESC Q) into lines after the 
first line in the buffer. If the cursor is at the 
beginning of the line when “*X. is issued, the fill 
prefix is reset (i.e., there is no fill prefix). It 
can be used to establish a left margin. 





set-fill-column 

sets the fill column in the current buffer to be the 
horizontal position where the cursor is now. The 
fill column is the "right margin" used by ESC Q to 
fill and adjust text, by fill mode to fill and adjust 
text, and by ESC S to determine where to center. The 
fill column is the first column in which text is not 
to be placed. The new value of the fill column is 
printed out in the minibuffer. If a positive numeric 
argument is given, e.g., “U 72 “XF, the fill column 
is set to that value. 


center-—line 
Centers the current line, according to the fill 
column set by “XF. 


runoff-fill-paragraph 

"Fills" the current paragraph, with a ragged right 
margin and properly broken lines (like the Multics 
runoff/compose commands with  .na/.all). With a 
positive numeric argument (e.g., ESC 1 ESC Q), fills 
and adjusts the current paragraphs with aligned left 
and right margins, properly broken lines, and padded 
white space, if necessary (like runoff/compose with 
.fi and .ad/.fin and .alb). Right margin is 
determined by the fill column, left margin by the 
fill prefix. Any runoff/compose control lines count 
as their own paragraphs. See “XF to set fill-column, 
and “X. to set fill prefix. 


fillon 

Turns on Fill mode (a minor mode) in this buffer. [In 
Fill mode, text is wrapped around lines so as not to 
extend past the fill column (see “XF to set that). 
When a space, tab, or punctuation mark is placed 
after a word which passes the fill column, the line 
is broken at the first white space back from the end 
of the line. To insert a character to cause a line 
deliberately to extend past the fill column, either 
type CR or precede the character with “Q. 
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ESC X filloff 
Turns off Fill mode in this buffer, if it is on. 
i) ESC X runoff-fill-region 
ad Fills/adjusts an entire region in the same way as ESC 
Q does to a paragraph. It does not respect paragraph 
breaks: this makes it only marginally useful. 


Literal Character Entry 


\ escape-char 
A \NNN inserts the character whose value is NNN into 
the buffer, where NNN are 1 to 3 octal digits. For 
example, \14 inserts a formfeed (“L). A \\ inserts a 
\; \# inserts a #; \@ inserts an @. A \ followed by 
any other character inserts \ and that character. 


=) quote~char 
"Quotes" the next character, i.e., inserts it into 
the buffer literally. This is used to enter control 
characters and other "funny" characters into the 
buffer, e.g., “Q# to insert a pound sign. 


Special Purpose Keys 


" “J noop | 
iC 4 Linefeed; ignored. See also * ies Good for exiting 
aS local displays (such as *X*B, apropos, etc.) 


“L redisplay-command 

Clears the screen, and displays the current window of 
the current buffer, centered about the current line. 
Useful if your screen is messed up by messages 
(preventable with ESC X accept-msgs), non-Emacs 
output, etc. With a positive numeric argument, moves 
current line to that many lines below top of screen; 
ESC O*L or ESC 1°L moves current line to top, for 
example. With a negative numeric argument, moves the 
current line to that many lines above the bottom of 
the screen; ESC -1°L moves to the bottom of the 
screen, ESC -2°L moves to two lines from the bottom, 
etc. 


“U multiplier : 
When not followed by a positive number, multiplies 
the next request by 4 for each use, e.g., “UD 
deletes 4 characters. Typing “U°U"D deletes 16. 
With a positive number, uses the number, e.g., “U13x 
inserts an x 13 times. A “U is considered a positive 
numeric argument. 


() ESC escape : 
ous Used to enter two-keystroke key sequences, and to 
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supply numeric arguments to requests. For example, 
to enter the ESC K request, type ESC, then aK. To 
supply a numeric argument to a request, type ESC, the 
number (negative numbers are preceded by a minus 
sign), and the request. For example, ESC 3 “D 
deletes 3 characters. : 


escape-dont—exit-—minibuf 

Is the same as ESC, and can be used for all requests 
beginning with ESC, and numeric arguments. However, 
can be used in the minibuffer when typing ESC would 
terminate the minibuffer, as in some of the special 
search stirngs. 


extended—-command 

Prompts for the name and arguments of an extended 
request in the minibuffer, terminated by CR. To find 
out about an extended command, type: 


ESC X describe <name-of~command> CR 


begin-macro-collection 

Starts learning all that follows as a macro, until 
“X) or an error occurs. All requests and input 
between “X( and *X) are remembered as a macro, which 
can be executed by “XE, or saved and assigned to a 
key by ESC X save~macro, and displayed by “X*. 


end-macro-collection 

Ends a macro definition. The requests and input 
typed since “X( become the "last macro defined" for 
“XE. If given, a numeric argument, re-executes the 
defined macro as “XE does (see that request). See 
“X( for what a macro is. 


show-last—or-current—macro 

Displays the requests (as keystrokes, e.g., “A, 
esc-B, etc.) in the last macro defined (see “X( and 
SA) If given a positive numeric argument, e.g., 
“U*X*, displays the keystrokes and command names. 


execute—-last-editor-macro 

Executes the last macro defined (by “X( and “X)), one 
or many times depending on the numeric argument to 
this request. 

With: 


No argument 
Executes it once. 
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O( i.e., ESC O°*XE) 
Executes it over and over, pausing after 


each execution. Type a space to go on to 
the next, CR or “G to stop repeating. 
9999 


Does it that many times. 


9999-infinity 
Does it until an error occurs. 


“XQ macro-query 
Queries the user during the execution of a macro so 
that he can: 


continue execution by typing a space 
stop execution by typing a “G 


restart execution from the beginning by typing a 
CR or other character 


This request can only be used by including it ina 
macro definition. MThus: 


“X( “S form CR “XQ ESC U “X) 


locates occurrences of "form" and queries the user 
before uppercasing them. 


ESC X save-macro 

NaveS a macro, assigning it to a key. Invoke it 
after a macro has been defined. Prompts for a 
command name to assign to the macro, and akey. A 
null response for the key does not assign it to any 
key; ESC X set-key can be used later. When a key has 
been assigned, this key invokes that macro; it takes 
arguments identical to “XE. 


ESC X edit-macros 
Produces a symbolic file of all keyboard macros 
defined in the current buffer and places it in a new 
buffer. The keyboard macros may then be written out 
for later loading, edited, redefined, or compiled 
into Lisp code. See Appendix D for full information. 


ESC X show-macro <macro-name> | 
Displays an editor macro (defined with ‘*X( and “X) 
the same as show-last-editor-macro does, but takes 
the name assigned to the macro (by ESC X save-macro) 
as an argument. 
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backward-char 

Moves backward one character in the buffer. Tabs and 
the newline characters at the ends of lines count as 
one character. Beeps as for “G at the beginning of 
the buffer. Repeats with a positive numeric 


argument; moves forward and repeats with a negative 
numeric argument. 


forward-char 

Moves forward one character. Tabs and newlines count 
as one character each. Beeps as for “G at the end of 
the buffer. Repeats with a positive numeric 
argument; moves backward and repeats with a negative 
numeric argument. 


rubout—char 

Deletes the previous character (before the cursor, 
which is usually the last character typed). Note 
that # deletes the character to the left of the 
cursor, while “D deletes the character at the cursor. 
Repeats with a positive numeric argument, deletes the 
character at the cursor and repeats with a negative 
numeric argument. | 


\177 (delete key) rubout-char 


Deletes the previous character (before the cursor, 
which is usually the last character typed). Note 
that \177 deletes the character to the left of the 
cursor, while “D deletes the character at the cursor. 
Repeats with a positive numeric argument; deletes the 
Character at the cursor and repeats with a negative 
numeric argument. 


delete-char 

Deletes the character to the right of the current 
point. This is the character on which the cursor 
Sits. Moves the rest of the line one to the left, 
closing up the space. Deleting a newline at the end 
of a line merges lines. Repeats with a positive 
numeric argument; deletes the previous character and 
repeats with a negative numeric argument. 


Lines (Moving in and by/Deleting) 


” A 


“E 
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go-to-beginning-of~line 
Positions to the beginning of the current line of the 
buffer, i.e., right before the first character. 


go-to-end-of-—line 


Positions to the end of the current line, i.e., after 
the last character and before the linefeed. On an 
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empty line, this is the same as the beginning of the 
line. 


next~lLine-command 

Positions to the next line of the buffer. If on the 
last line, appends a new empty line to the bottom of 
the buffer, and positions to the beginning (and end) 
Of 3%. Successive “Ns and “Ps try to maintain the 
same horizontal position. Repeats with a positive 
numeric argument; performs “Ps and repeats with a 
negative numeric argument. 


prev-Line-command 

Moves to previous line of the buffer. Beeps as for 
“G if on first line of the buffer. Attempts to 
maintain the same horizontal position; successive 
“P's and “N's try to maintain the original horizontal 
position. Repeats with a positive numeric argument; 
moves to next line and repeats with a negative 
numeric argument. 





linecounter 

Displays in the minibuffer the number of lines in 
this buffer, the line number (the first line is line 
1) of the line the cursor is on, and the dprint 
column position. 


go-to—line~number 
Goes to a given line, specified by line number, from 
the top of the buffer. The positive numeric argument 
specifies the line number. For instance, ESC 25 HSC 
G goes to line 25. 


kill-—to-beginning-—of-—line 
Kills all the text to the left of the cursor on the 
current line. The killed text is saved on the kill 


ring, and may be retrieved with “Y. 


kill-lines 

Kills to end of line; when already at end of line, 
deletes the linefeed (merges lines). If on an empty 
line, deletes it. If given a positive numeric 
argument, deletes that many lines, starting from the 
current point on the current line. Successive Ks 
merge killed text on the kill ring. 


backward-word 

Goes backward one word. If in the middle of a word, 
goes to before the beginning of that word. skips 
backward over all white space to get to the next 
word. Underscores and backspaces count as parts of 


_ words. Repeats with a positive numeric argument; 
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goes forward and repeats with a negative numeric 
argument. 


forward-word | 

Goes forward one word. If in the middle of a word, 
moves to the end of the current word. Leaves point 
immediately after that word. Passes over all 
punctuation and white space before the word. 
Underscores and backspaces count as parts of words. 
Repeats with a positive numeric argument; moves 
backward and repeats with a negative numeric 
argument. 


rubout—-word 

Deletes the word to the left of the current point. 
More specifically, deletes going backward, deleting 
characters until the beginning of a word. Successive 
words deleted with ESC # are merged and can be 
retrieved with one “Y. Repeats with a positive 
numeric argument; deletes forward and repeats with a 
negative numeric argument. 


ESC \177 rubout-word 


Esc D 


ESC © 


HOC L 


Deletes the word to the left of the current point. 
More specifically, deletes going backward, deleting 
characters until the beginning of a word. With a 
positive numeric argument, deletes the specified 
number of words. Deletes forward the specified 
number of words with a negative numeric argument. 
Successive words deleted with ESC \177 are merged and 
may be retrieved with one “Y. 


delete-word 

Deletes the word to the right of the current point. 
More specifically, deletes forward, deleting all 
white space and punctuation and characters until the 
end of the next word. Repeats with a positive 
numeric argument; deletes backward and repeats with a 
negative numeric argument. 


capitalize-initial-word 

Capitalizes the initial letter of a word, e.g., Word. 
If the cursor is ina word or immediately after a 
word, capitalizes the first letter of that word. 
Otherwise, acts on the next word. Leaves cursor 
immediately after the word capitalized. 


lower-—case-word 

Converts a word to all lowercase, e.g., word. If the 
cursor is ina word or immediately after a word, 
lowercases that word. Otherwise, lowercases the next 
word. Leaves cursor immediately after the word acted 
upon. 
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upper-case-word 

Converts a word to all uppercase, e.g., WORD. If the 
cursor is ina word or immediately after a word, 
uppercases that word. Otherwise, uppercases the next 
word. Leaves cursor immediately after the word acted 
upon. | 


underline-—word 

Canonically underlines a word. If the cursor is ina 
word or immediately after it, underlines that word. 
Otherwise, underlines the next word. Leaves the 
cursor immediately after the underlined word. 
Although the underlined word looks peculiar on the 
screen, it is correct. 


remove-underlining-from-word 

Removes underlining from the current or previous 
word; the rules for selecting which word are the same 
as those used by uppercase-word (see ESC JU). 


backward-sentence 

Goes to the beginning . of the current sentence, i.e., 
just before the first letter. If already at the 
beginning of a sentence, goes to the beginning of the 


previous sentence. The beginning of the first word 
after a blank line always counts as the beginning of 
a sentence. Repeats With a positive numeric 


argument; goes forward and repeats with a negative 
numeric argument. 


forward-sentence 

Moves forward to the end of this’ sentence. If at the 
end of a sentence, moves forward to the end of the 
next sentence. Ends of paragraphs are implicitly 
ends of sentences, whether or not an end-of-—sentence 
punctuation (period, question mark, exclamation 
point) appears. Repeats with a positive numeric 
argument; moves backward and repeats with a negative 
numeric argument. 


kill-backward-sentence 

Kills backward to the beginning of this sentence; 
kills as much of the sentence as thus far typed. 
Successive kills via “X# and other reverse-killing 
requests (e.g., ESC #) merge, and may be retrieved 
with one “Y. Repeats with a positive numeric 
argument; kills forward and repeats with a negative 
numeric argument. 


kill-backward-sentence 


Kills backward to the beginning of this sentence; 
kills as much of the sentence as thus far typed. 
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Successive kills via “X\177 and other reverse-killing 
commands (e.g., ESC #) merge, and may be retrieved 
with one “Y. Repeats with a positive numeric 
argument; kills forward and repeats with a negative 
numeric argument. 


kill-to-end-of-sentence 
Deletes text going forward from the cursor to the end 


of the current sentence. If at the end of a 
sentence, deletes forward to the end of the next 
sentence. Sentences and other text killed 


consecutively in this fashion are merged, and may be 
retrieved with a single “Y. With a positive numeric 
argument, kills the specified number of sentences. 
Kills backward the specified number of sentences with 
a negative numeric argument. 


beginning-of-paragraph 

Moves to the beginning of the current paragraph. If 
already at the beginning of a paragraph, moves to the 
beginning of the previous paragraph. The beginning 


of a paragraph is the beginning of the first line of © 


the paragraph. The definition of paragraphs is 
controlled by the paragraph-definition-type option: 
if 1, blank lines separate paragraphs; if 2, an 
indented line starts a paragraph. The Multics runoff 
or compose command's control lines count as 
individual paragraphs. Repeats with a positive 
numeric argument; moves forward and repeats with a 
negative numeric argument. 


end-of-paragraph 

Moves to the end of the current paragraph. If at the 
end of a paragraph, moves to the end of the next 
paragraph. The end of a paragraph is the end of the 
last line of the paragraph. The definition of 
paragraphs is controlled by the 
paragraph-—definition-type option: if 1, blank lines 
separate paragraphs; if 2, an indented line starts a 
paragraph. The Multics runoff or compose command's 
control lines count as paragraphs. Repeats with a 
positive numeric argument; moves backward and repeats 
with a negative numeric argument. 


mark-paragraph 

Puts the mark at the beginning of the current 
paragraph; puts the cursor at the end of the current 
paragraph. See ESC [ for a definition of paragraphs. 
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next-screen 

Displays next screenful of the current buffer. 
Leaves cursor at upper left hand corner of screen. 
With a positive numeric argument, pages forward the 
specified number of screensful and displays it; with 
a negative numeric argument, moves backward the 
specified number of screensful (previous screens) and 
displays it. 


prev-screen 

Displays the previous screen (one back) of this 
buffer, leaving cursor at the top of it. With a 
positive numeric argument, moves backward the 
specified number of screensful and displays it; with 
a negative numeric argument, moves forward the 
specified number of screensful and displays it. 


redisplay-—command 

Clears the screen, and displays the current window of 
the current buffer, centered about the current line. 
Useful if your screen is messed up by messages 
(preventable with ESC X aeccept-msgs), non-Emacs 
output, etc. With a positive numeric argument, moves 
current line to that many lines below top of screen; 
ESC O°L or ESC 1°L moves current line to top, for 
example. With a negative numeric argument, moves the 
current line to that many lines above the bottom of 
the screen; ESC -1°L moves to the bottom of the 
screen, ESC -2°L moves to two lines from the bottom, 
etc. 


move~to—screen-edge 

Moves to top, bottom, or other point on screen. ESC 
1 ESC R or ESC O ESC R moves to the top line of the 
screen, ESC 6 ESC R moves to 6 lines from the top, 
“U*U*U ESC R or ESC -1 ESC R moves to the bottom. 
ESC -2 ESC R moves to the second line from the 
bottom, etc. Leaves the cursor at the start of the 
selected line. 


scroll-current-window 

Scrolls the current window up a line, with the cursor 
maintaining its position relative to the text. With 
a positive numeric arguemnt, e.g., “U°Z°V, scrolls up 
the specified number of lines. With a negative 
numeric argument, e.g. ESC -3 “Z°V, scrolls down the 
specified number of lines. 


go-to-beginning-of-buffer 
Moves to the beginning of the current buffer, i.e., 
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before the first character in the buffer at the top 
of the document being edited. 


go-to-end-of~—buffer 

Moves to the end of the current buffer, i.e., before 
the newline on the last line of the current buffer at 
the bottom of the document being edited. You cannot 
position beyond that newline. 


select—-buffer 

Switches to another buffer. Prompts for the name of 
that buffer, terminated with CR. If that buffer does 
not already exist, it is created. All key bindings, 
fill column, comment column, comment prefix, etc., 
associated with that buffer are put in effect. The 
last point that you were at in that buffer becomes 
the current point. Responding to “XB's prompt with 
only a CR goes to the last buffer you were in. 


lList-buffers 

Produces listing of buffers and their pathnames. A 
">" marks buffer you came from, "*" says buffer is 
modified since it was last read or written. Proceed 
with editing, or type linefeed to refresh screen. 


mark-whole-buffer | 

Puts the mark at the end of the buffer and the cursor 
at the beginning. This "marks" the whole buffer, so 
that “W deletes it, etc. The linefeed at the end of 
the buffer is not in the marked region, but “XH “W 
“XB... “Y effectively moves a whole buffer. 


kill-buffer 

Kills (destroys) a buffer. Prompts for the buffer's 
name, terminated by CR. A response of CR kills the 
current buffer. Buffers can be killed to conserve 
storage, to prevent their appearance in buffer 
listings, or to prevent being queried when quitting 
with “X°C. 


unmodify-buffer 

Marks the current buffer as not modified. Emacs does 
not mention this buffer when querying before quitting 
the editor. This is useful after accidentally 
modifying a buffer which you only intended to 
examine. 


edit-buffers 


Enters the buffer editor. If “Z°B is given no 
argument, the buffer editor sets up its display in 
the current window. If given a positive numeric 


argument, e.g., -U “ZB, the buffer editor finds some 
other appropriate window (if in two-or-more-window 
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mode) to set itself up in. See Section 16 for full 
information on the buffer editor. 
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Multiple Windows 


“XO remove-window 
Removes the window in which the cursor appears from 
the screen. The cursor is moved to the window that 


had been visited just before the current window was 
entered (that is, the next-most-recently visited 
window). The space occupied by the departing window 
is divided among its neighbors. With a positive 
numeric argument, removes the window specified, where 
the topmost window is 1. 


“x1 expand-window-to-—whole-screen 
Expands the window in which the cursor appears to 
fill the whole screen; all other windows are removed. 
This in essence returns to "one window mode" from 
having any number of windows. The cursor retains its 
position in the text. 


“X2 create-—new-window-and-go-there 
Creates anew window at the bottom of the screen, 
redividing the screen equally among all the windows. 
The cursor moves to the new window, which has a 
oe : default buffer name created from its window number. 


create—new-window-and-stay—here 

Creates anew window at the bottom of the screen, 
redividing the screen equally among all the windows. 
The cursor remains where it is. The new window, 
which has adefault buffer name created from its 


window number, becomes the "least-recently visited 
window." 
“X4 select-another-window 


Moves the cursor to the least-recently visited window 
on the screen. That window then becomes’ the 
most-recently visited. Thus, successive applications 
of “X4 visit all windows on the screen. This is a 
good request to use when you want to visit some new 
buffer or file, but not overwrite windows containing 
information you have been looking at recently. With 
a positive numeric argument, e.g., ESC 3 “X4, goes to 
that window, i.e., window 3. 


“XO select-other-window 
Moves the cursor to the other window (in two-window 
mode), or to the previous Window, implicitly 
(usually) switching buffers. The mode line is 
os updated to reflect the new buffer. The cursor 
(| appears at the last point it was in the new window. 
a In general, the cursor enters the window used last, 
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immediately before the current window was entered, so 
this request switches you back and forth between the 
two most-recently used windows. 


page-other-—window 

Valid only when more than one window exists. 
Displays the next screenful of the other window's 
buffer (i.e., the one the cursor is not now in). 
With a positive numeric argument, pages forward the 
specified number of screensful, and displays it. 
With a negative numeric argument, pages the other 
window backward. When more than two windows are in 
use, the next most recently visited window is 
considered to be the "other window". Very useful for 
"paging" through compiler diagnostics while editing a 
program. 


edit-windows 

Enters the window editor to create, realign, destroy, 
or visit windows. If “Z°W is given no argument, the 
window editor sets up its display in the current 
window. If given a numeric argument, e.g., “U “*Z*W, 
the window editor finds some appropriate window to 
set itself up in. see Section 16 for full 
information on the window editor. 


Mail/Messages 
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send-mail 

Enters the Emacs mailer (RMAIL) to compose outgoing 
mail. This request prompts for the mail subject 
terminated by CR. For full information on reading 
and sending mail, see Appendix B. 


rmail | 

Enters the Emacs RMAIL subsystem to read mail. 
Without a numeric argument, uses your default 
mailbox. With a positive numeric argument, e.g., “U 
“XR, prompts for a mailbox name, which can take a 
form Like Washington.States, Salter, 
>udd>Sales>Complaints, etc. The first message in the 
mailbox is placed ina buffer in RMAIL mode. Type 
‘'q" to exit RMAIL and delete all mail queued for 
deletion during RMAIL. Refer to Appendix B for full 
information on RMAIL and reading and sending mail. 


accept—msgs 
Accepts Multics interactive terminal messages into 


Emacs buffers, one buffer per correspondent. 
Messages are displayed as a local display as they 
arrive. All correspondence to and from each 
correspondent is maintained in a buffer named 
"Messages from <PersonName>." In such a buffer, 


carriage return is bound to respond-from—buffer, 
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which transmits messages when you type a line into 
that buffer. In these buffers, conversations 
"transcript" as with the Multics send message command 
in input mode (see the MPM Commands). The following 
key bindings are set up globally by accept-msgs (see 
Appendix F for more information): 


“X: message-response-command 
Responds to last sender from minibuffer. 


“X' go-to-new-message-buffer 
Goes to a message buffer. 
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re-execute—-command 

Reexecutes the last keystroke (request), other than 
“J or “C. Useful for skipping successive words, etc. 
Repeats with a positive numeric argument. Reexecutes 
search requests using the same search string. 
Reexecutes extended requests, using the same 
arguments (if any). 


twiddle-chars 

Transposes (interchanges) the last two characters 
typed, e.g., I like Mutl”“Tics becua”Tse..., becomes 
"IT like Multics because... 


multiplier 

When not followed by a positive number, multiplies 
the next request by 4 for each use, e.g., “U"D 
deletes 4 characters. Typing “U°U"D deletes 16. 
With a positive number, uses the number, e.g., “U13x 
inserts an x 13 times. A “U is considered a positive 
numeric argument; however, “U -6, for example, is an 
argument of -6. 


setab <abbrevi> <expansionl> <abbrevn> <expansionn> 
Defines one word as an abbreviation for another, for 
Speedtype mode. For instance: 


BSC X setab edr editor 


defines edr as the abbreviation for editor. Accepts 
multiple pairs of arguments. If the second string 
(the thing being abbreviated) is many words, or has 
special characters in it, put it in quotes. The 
abbreviation can be 4 characters or less. 


speedtype 

Enters Speedtype minor mode in this buffer. 
Speedtype allows words to be used as abbreviations 
for other words. ESC X setab defines abbreviations. 
When aspace, newline, tab, or punctuation mark is 
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typed after an abbreviation, the abbreviation is 
removed from the text and replaced by its expansion. 
Precede punctuation or spaces with “Q to deliberately 
avoid Speedtype expansion when in this mode. 


speedtypeoff 


Turns off speedtype mode in this buffer, if it is on. 


Modes 


alm-mode 

Enters ALM major mode in this buffer. ALM mode 
consists of many requests and variable settings 
Suitable for the creation and editing of ALM programs 
(see Appendix C). 


electric—plil-—-mode 

Enters Electric PL/I mode in the current buffer. 
Electric PL/I mode is a variant of PL/I mode in which 
semicolons and colons have violent automatic 
"electric" action which may be disturbing to some, 
but useful to others. See Appendix C. 


fortran-—mode 

Enters FORTRAN major mode in this buffer. FORTRAN 
mode consists of many requests and variable settings 
Suitable for the creation and editing of FORTRAN 
programs. See Appendix C for a list of the requests 
and a description of this mode. You can issue the 
request ESC xX apropos fortran CR in a FORTRAN mode 
buffer for a list of relevant requests in this mode. 


fundamental—mode 

Enters Fundamental major mode, the mode (set of key 
bindings and variable settings) that all buffers 
Start out in. This can be used to "undo" any other 
major mode that you may have set. 


lisp-—mode 

Enters Lisp major mode in this buffer. Lisp mode 
consists of many requests and variable settings 
suitable for the creation and editing of Lisp 
programs. See Appendix C for a list of the requests 
and a description of this mode. 


pli-mode 

Enters PL/I major mode in this buffer. PL/I mode 
consists of many requests and variable settings 
suitable for the creation and editing of PL/I 
programs. See Appendix C for a list of the requests 
and a description of this mode. You can issue the 
request ESC X apropos pl1 CR in a PL/I mode buffer 
for a list of relevant requests in this mode. 
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set-compile-options "option string" 

In language modes that support ESC 1: fOr 
compile-buffer, e.g., PL/I, FORTRAN, sets non-default 
compilation options to be given to the appropriate 
compiler. 


set-compiler <compiler> 

pets the name of the compiler to be used by the 
compile-buffer request (usually ESC °C) in those 
language modes that compile buffers this way, e.g., 
PL/I, FORTRAN. The single argument to ESC X 
set-compiler is the compiler name. 


ldebug 

Enters 4 "“hisp Top Level" buffer in Lisp Debug mode. 
Forms typed into this buffer are evaluated and the 
value is displayed by placing it in this buffer. 
When ESC X ldebug has been used, all Lisp errors in 
Emacs trap into this buffer. ESC P restarts a break. 
see the Extension Writers' Guide for more 
information. 


Printing Terminal Usage 
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view-lines 

For printing terminals, prints the current line. 
With a positive non-zero numeric argument, prints the 
specified number of lines, beginning with the current 
and continuing on down. With a negative numeric 
argument, prints the specified number of preceding 
lines. Leaves you after them, unless argument is 1 
or not supplied, in which case it leaves you on the 
current line, after printing it. ESC O°XV views the 
region (between cursor and the mark). Thus, “XH ESC 
O XV prints the whole buffer.' 


toggle-redisplay 

Turns off all screen updating until the next “X*T, “°G 
(not “X*G or “Z°G), or error happens. This request 
can be used on slow terminals with no insert/delete 
facilities to avoid excessive printing time for 
operations such as typing in the middle of a line. 


open-space 

Opens up space by putting a newline ahead of the 
current point. Pushes all lines of the buffer below 
the current line down one. With a positive numeric 
argument, e.g., “U°U"O, opens up the specified number 
of lines (16 in this case). See X*O to remove 
(extra) blank lines. 
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eval-lisp-line 
Prompts for a string for Lisp to evaluate; puts a 
pair of parentheses around it, evaluates it in Lisp 
(with ibase = 8), and prints out the Lisp value in 
the minibuffer (base = 8, *nopoint nil). To geta 
variable value, use ESC ESC progn <varname> CR. 


ildebug 

Enters a "Lisp Top Level" buffer in Lisp Debug mode. 
Forms typed into this buffer are evaluated and the 
value is displayed by placing it in this buffer. 
When ESC X Ildebug has been used, all Lisp errors in 
Emacs trap into this buffer. ESC P restarts a break. 
pee the Extension Writers' Guide for more 
information. 


loadfile <path> 

Loads a private Emacs extension package into the 
editor. The argument is its pathname. See the 
Extension Writers' Guide for more information. 


loadlib <library> 

Loads an extension package into Emacs. Normally, 
such packages are "autoloaded" when-requests in them 
are invoked, but from time to time, new, 
experimental, or highly specialized packages may 
require being loaded in this way. The single 
argument is the name of the package to be loaded. 
Loading a package makes the requests in it available. 
see the Extension Writers’ Guide for more 
information. 


Additional Optional Settings 


ESC X 


opt 
Sets internal flags and defaults, each of which have 
names. Takes three forms: 


opt list 
Lists all options and settings. 


opt NAME VALUE 
sets option value. 


opt status NAME 
Reports setting of one option. 


Where: 

NAME is an option name and VALUE is an 
acceptable value for the named option. Values 
may be on, off, or numbers, depending on the 
option. Code, such as’ start-ups, can set these 
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Lisp variables (on/off => t/nil). Current. 
options are: 


- display-ctlchar-with-“ 
at Causes control characters to print as “P 
instead of \020. 


suppress-—ctlchar-—display 
Suppresses the display of control 
characters. Any character which would 
print as \NNN (except \177) is not 
displayed. 


suppress-rubout-display 
Suppresses the display of rubout 


characters. Causes \177 to never be 
displayed. Useful when reading ALM listing 
segments. 


suppress-—backs pace-—display 
Suppresses the display of backspaces. 
Causes underlined "foo" to print as 
me, Gee OD Ol 


rdis-whitespace-optimize 
Avoids printing white space when clever 
terminal control would go faster. Default 
at less than 1200 baud; moderately 
( expensive. 


rdis-wosclr-opt 
Wipes out screen lines before filling 
screen. Try it both ways to see what this 
means. 


paragraph-definition-type 
1 (default) = blank lines precede 
paragraphs. 
2 = indented line starts one. 


find-file-set-modes 
When on, find-filing foo.pli sets PL/I 
mode, etc. 


track-eol-opt 
When on, “N, “P at end of line stick to 
ends of lines. 


default-fill-—~column 
Sets fill column for new buffers. 


default-comment—column | 
ee Sets comment column for new buffers (0 
“- origin). 
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pop-up-windows 
When on, “XB, “X°F, “X°E, etc., find an 
appropriate place on the screen to put up a 
window as opposed to replacing contents of 
current window (experimental; see 
Appendix H). 


option 

Is the same as ESC X opt. 

set-minibuffer-size <size> 

Sets the size of the minibuffer/prompting area on the 
screen to any value. The single argument to ESC X 
set-minibuffer-size is the decimal number of lines 
that should be devoted to this function, from 1 to 6. 
The default is two. With many-line minibuffers, many 
messages and errors may appear at once. Use ESC X 
reset—-minibuffer-size to reset the minibuffer size to 
its default of two lines. 

reset-minibuffer-size <size> 

Resets the size of the minibuffer/prompting area to 
its default of two 1iness see ESC x 
set-minibuffer-~size. 

set-screen-size <size> 

Sets the size of the main editing area (the area 
above the mode line). The default is all of the area 
above the mode line. The decimal argument to ESC X 
set-screen—-size is the number of lines in the main 
editing area. ESC X reset-screen-size resets the 
main editing area size to its default value. ESC X 
set-screen-size is usually used to reduce the amount 
of redisplay at low terminal speeds. 
reset-screen-size <size> 

Resets the size of the main editing area of the 
screen to its default, namely, all of the space above 
the mode line. See ESC X set-screen-size. 

set-key <keyname> <command=name> 

Assigns key bindings in the current buffer. Takes 
two arguments, the key name and the command name. 
Makes that key execute that request in this buffer. 
The command name is what describe, apropos, or 
make-jwall-chart give; the key name can be anything 
like the names in this documentation, e.g., “X, “x, 
ESC ESC, “Xq, control-p, c-p, meta~f, ESC “f, CR, “X 
“F, “X CR, \177, #, A, “P, ete. See Section 15 for a 
full description of acceptable key names. 
set-permanent—key <keyname> <command-—-name> 


Sets permanent (default in all buffers) key bindings. 
Otherwise, works exactly like ESC X set-—key. 
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set-—-search~-mode <search-mode> 


the bindings of “S and “R to invoke several 


different forms of searching. The argument is the 
search mode, and can be: 


string 


Searches forward/backward (depending on whether 
you are searching with “S/°R) for the exact 
character string typed (the default). 


regular-expression or regexp 


Interprets the search string as a regular 
expression (°S now behaves as ESC /). No 
reverse searching is available if this search 
mode is set (°R is unbound). 


character 


Searches for the single character typed, (end 
with an ESC) unless that character is one of the 
following, which are interpreted specially: 


“A 
invokes the ITS string search request, or 
reverse ITS string search request ("R). 
(See ITS-string-search for more details.) 

“G 
aborts the search 

“J 
finds next/beginning ean a line, or 
previous/end of line (°R). 

“M 
finds next/beginning of a Line, -or 
previous/end of line:("R). 

“Q 
reads another character and searches for it 
regardless of its value. You should use “Q 
when searching for control characters. 

“R 
reverses the direction of the search and 
reads another character. The character 
read is then processed as if it were read 
by “R, or “S when searching with “R. 

“Ss 


searches for the current default string. 
The default is displayed in the minibuffer. 
If the search succeeds, the cursor is left 
after/before the character(s) found. 
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A “S or “R reads characters and either adds them 

to the search string, or performs some action as oo 
specified by the character. All non-control J) 
characters are added to the search string. With 

the exception of the control characters listed 
below, all the control characters are invalid 

and are ignored. The special control characters 
recognized by “S and/or “R are: 


eee 
removes the last character from the search 
string. If there are no characters in the 
search string, the search aborts. 
if 
is the same as \177. 
“B 


changes the starting point for searches 
requested by “S or BOCs When “S is 
entered, searches are made starting from 
the current cursor position. A “B starts 
searches from the beginning of the buffer. 
A subsequent B starts searches from the 
current cursor position, etc. 


replaces the search string with the current OD) 
default search string, and "rotates" the / 
list of defaults. The default search 
string is the last string used by any other 
search request, or by the use of “S (see 
below) to this request. A “D permits you 

to "walk" through the last sixteen strings 

you searched for to find the one you wish 

to search for again. 


aborts the search. 
redisplays the screen. 


reads a character and adds it to the search 
string regardless of its nature. A Qiis 
the only way to place control characters 
into the search string. 


reverses the direction of the search. Any 

characters read after the “R are processed 
by the “R request, or by the “S request if a 
you are using ‘R. / 
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searches forward/backward for the current 
search string. If found, the cursor is 
placed after/before the string. In any 
event, the current search string is pushed 
onto the top of the list of default search 
strings. 


adds the current default search string to 
the search string typed so far. fThus, 
ae Gee Gers searches forward for two 
successive occurrences of the default 
search string and “R°Y*Y*R searches 
backward. 


ESC 
searches forward/backward for the current 
search string and then exits the “S/*R 
request. If the previous character typed 
to “S was “S, ESC only exits and does not 
search. The search done by ESC is 
identical to that done by a ‘S. 


incremental 


Searches by character forward/backward (7S or 
“R) for a string character as you type the 
string. The string accumulates in the 
minibuffer. That is to say, the cursor moves in 
the main window finding more and more accurate 
matches for the string you are typing as you 
specify further characters of it. The general 
idea is to find the string you are looking for 
before you finish typing it, at which point you 
type ESC. The cursor is left after/before the 
string found in the buffer. It is recommended 
only for high speed lines: try it in order to 
get the general idea. The following characters 
have special meaning when typing the search 
string to incremental-search; all normal 
"orinting" characters are searched for: 


“s 
for “S, finds the next match for the 
current search string. If the current 
search string is empty, retrieves the 
default search string set by the last 
search command. 

“Ss 


for “R, reverses the direction of search, 
entering incremental-search. The first 
occurrence of the search string is found 
going forward in the buffer. 
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ESC 
ends the incremental search to allow other 
requests to be typed. It is very important 
to remember to type ESC. 


aborts the incremental search, and returns 
to the place from which it was started. 


# or \177 
removes the last character from the search 
string, and moves the cursor to the place 
it was before you typed that character. 


“L 
redisplays 

“Q 
quotes the next character, i.e., puts it 
into the search string literally. 

“R 
for “S reverses direction of searching. 
This enters reverse-incremental-search, 
searching backward for the first occurrence 
of the current search string (which is 
always at the current ‘jpoint in the buffer). 

“R 


for “R, repeats the search, going backward, 
for the current search string, i.e., finds 
the next occurrence of it. If the current 
search string is empty, retrieves’ the 
default search string. 


If an attempt is made to add a character to the 
search string which produces a _ search string 
that cannot be found, Emacs rings the terminal 
bell and removes the character from the 
minibuffer, leaving the cursor in place. If 
this occurs during a macro execution, however, a 
normal Emacs “G is done, aborting macro 
execution. 


All searches prompt, telling the type of search that 
has been invoked. 


je aig 
ae 
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APPENDIX A 


THE MULTICS EMACS COMMAND 


SYNTAX AS A COMMAND: 


emacs {-control args} {paths} 


FUNCTION: Enters the Emacs text editor, which has a large 
repertoire of requests for editing and formatting text and 
programs. Emacs is a display-oriented editor designed for use 
on CRI terminals. Several modes of operation for special 
applications (e.g., RMAIL, PL/I, FORTRAN) are provided; the 
default mode entered is Fundamental major mode, whose requests 
are listed below. 


ARGUMENTS : 


paths 
are pathname(s) of segments to be read in. Each is put into 
its own appropriately named buffer. 


CONTROL ARGUMENTS: 


-terminal type STR, -ttp STR 

specifies your terminal type to Emacs, where STR is any 
recognized editor terminal type or the pathname of a control 
segment to be loaded. The terminal type is set permanently; 
changing the Multics terminal type during a login session does 
not affect the type "remembered" by Emacs. If STR is not a 
recognized type, Emacs queries you after entry, providing a 
list of recognized types. This control argument must precede 
any other arguments and cannot be used with -reset or -query. 


-reset 
specifies that Emacs disregard the terminal type set by the 
-ttp control argument and set it in accord with the Multics 
terminal type instead. ‘This control argument must precede any 
other arguments, and cannot be used with -ttp or -query. 
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—~query 
causes Emacs to query the user for a terminal type without 
checking the Multics terminal type first. The query response 
can be any recognized editor terminal type. This control 
argument must precede any other arguments and cannot be used 
with -ttp or -reset. 


-~line speed N 
indicates linespeed to obtain proper 
users), where N is the output line baud 
This control argument 
but must precede paths. 


padding (for ARPANet 
rate in bits/second. 
can follow any one of the above three, 


NOTES : None of the control arguments is generally necessary; 
they are only used for solving various communications 
problems. 


ALPHABETIZED LIST OF FUNDAMENTAL MODE REQUESTS 

of Emacs Fundamental 
character. Everything preceding the 
last character of each request is arranged in this suborder, 
under that last character: “, ESC, ESC”, “X, “X*, *Z, “2* 
Extended requests are listed separately at the end. 


The following is a list 
alphabetized by the last 


mode requests, 





# rubout-char 

ESC # rubout-word 

“X# kill~backward-sentence 

@ kill-to-beginning-of-line 

“@ set-or-pop-the-mark 

“27,°@ set-named—mark 

CR new-lLine 

ESC CR cret-and-indent-relative 

“ACR eval-multics-command-Line 

ESC escape 

ESC ESC eval~lisp-line 

“XESC escape-dont-exit—minibuf 
escape-char 

ESC \ delete-white-sides 

ea a rubout-—char 

Esc \177 rubout-word 

PNA T kill-backward-sentence 

Bea begin-macro-collection 

“X) end-macro-collection 

“xX* show-last-or-current-macro 


a ES Ta 


A-2 
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>i 
C2 
©2 


ESC B 
ESC ~ 
“XB 
“X*B 
“ZB 
ag 
ESC C 
ae © 
“D 
ESC D 


“E 


rene t 


ESC E 


ata kA aR oe ERT eR TREE PPA ly si naararararaararasrad PT 


set-fill-prefix 


indent-for-—comment 
set-comment—-column 
kill—comment 


linecounter 
query-replace 


help-on-tap 
underline-word 
remove-underlining—from-word | 


regexp-search—command 


go-to-beginning-of—~buffer 
go-to-end-of-buffer 


describe-key 


beginning-of-paragraph 
end-~of-paragraph 


delete~lLine-indentation 
unmodify-buffer 


remove-window 
expand-window-to-whole~screen 
create-new-—window-and-—go-there 
create—new-window-and-stay—there 
select-another-window 


go-to-—beginning-of-line 
backward~sentence 


backward-—-char 
backword-word 
balance~parens—backward 
select-buffer 
list-buffers 
edit-buffers 


re-execute-command 
capitalize-initial-word 
quit-the-editor 


delete-char 
delete-word 
edit—dir 
go-to-end-of—line 
forward-jsentence 
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“XE execute-last-editor-macro 





“X*E comout—command 

“F forward-char _ 
ESC F forward-word . 4 
ESC “F balance-parens-—forward = 
“XF set-fill-column 

“X °F find-file 

“ZR get-filename 

“G command-quit 

ESC G go-to-line-number 

ESC °G ignore-prefix 

“XG get-variable 

“XG ignore prefix 

“ZG go-to~named-mark 

“Z2°G ignore-prefix 

ESC H mark-paragraph 

“XH mark-whole-buffer 

ESC I indent-relative 

ESC “I indent-to~fill-prefix 

“XI insert-file 

* J noop 

"K kill-lines ‘ 
ESC K kill~to-end-of-sentence a 
“XK kill-buffer i) 
“L redisplay-command 

ESC L lower-case-word 

“X*L lower-case-region 

ESC M skip-over-indentation 

“XM send-mail 

“N next-line-command 

ESC N down-comment-line 

“0 open-space 

ESC “*O split-line 

“XO select-another-window 

“x"O delete-blank-—lines 

“P prev-line-command 

ESC P prev~comment—-line 

“Q qguote~char 

ESC Q runoff-fill-paragraph 

“XQ macro-—query 

“R reverse-string-search a 
ESC R move-to-screen-edge . y 


A-4 CH27-00 


ser a ae mmr 
Leenaamel rr RE A TS SS 
EE 2 MT vr ETS Traore mary i 
Pare ET TT 


“XR 
“X*R 
“Ss 
ESC 
“xs 
“xs 
am 
oe 
8 


S 


ESC U 


XU 
“Vv 


ESC V 


ESC “V 


XV 
“2°V 


“W 


ESC W 


ESC “W 
“XW 


“X"W 
“ZW 


ESC X 


“XX 
“xX*X 
ie: 
ESC 


ESC “Y 


“2° 2 


Y 


rmail 
read=file 


string-search 
center-line 
global-print-—command 
save-same-file 


twiddle-chars 
toggle-redisplay 


multiplier 
upper-case-word 
upper-case~region 


next~screen 
prev-screen 
page-other-window 
view-lines 
scroll-current—window 


wipe-region 

copy-region 
merge—last—kills-with-next 
multi-word-search 
write-file 

edit-windows 


extended-command 
put-variable 
exchange-point-—and-mark 


yank 
wipe-this-and-yank-previous 
yank-mninibuf 


signalquit 


Extended Requests 


ESC 
ESC 
ESC 
BSC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 


PI Pd Pd PS Pd P< PS PS PS PS PS PS Pd PS 


accept—-msgs 
alm—-mode 

apropos <string> 
describe <extended-request> 
edit-macros 
electric-pli-mode 
Li iLOL L 

fillon 
fortran~-mode 
fundamental-mode 
ldebug 

lisp-mode 
List-named-marks 
loadfile <path> 
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ESC 
BSC 
ESC 
BSC 
ESC 
ESC 
BS¢ 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
BSC 
BSC 
RSC 
BSC 
ESC 
BSC 
ESC 
ESC 
BSC 


Pi Pt PS PS Pd Pd Bd P< Pd PS PS PS Pd PS PS PS PS PS PS PS PS Pd 


loadlib <library> 

lvars 

make-~wall-chart . 
opt <option> 
pli~mode (> 
replace 

reset-minibuffer-size <size> 

reset-screen-size <size> 

runoff-fill-region 

Save~macro 

set-comment-—prefix "string" 

set-compile-options "option string" 

set-compiler <compiler> 

set-key <keyname> <command~name> 

set-minibuffer-size <size> 

set-permanent—key <keyname> <command—name> 
set-screen~size <size> 

set-search-—-mode <search-mode> 

setab <abbrevi> <expansion!> <abbrevn> <expansion> 
Show-macro <macro=name> — ~ 7 
speedtype 

speedtypeoff 
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APPENDIX B 


EMACS MAIL 


The Emacs mail system provides a facility for reading, 
sending, and responding to Multics mail within Emacs, utilizing 
the standard Emacs features and the interfaces of the Multics 
mail system. There are two basic functions, sending mail and 
reading mail. 


SENDING MAIL 


“XM 
The Emacs request for sending mail is: 
“XM, send=-mail 


Issuing this request puts you in MAIL mode and prompts for a 
"Subject," which should be supplied and terminated by a carriage 
return. This subject is incorporated into the buffer name, so it 
should be short. A buffer is formatted with the mail in it, 
header prefabricated. The buffer is placed in an available 
window, as with “X"E (comout-command). Fill mode is turned on 
with a fill column of 72. The buffer is now in MAIL mode, which 
defines the following requests: 


“XA mail-append 
Goes to the end of the body of the mail. Use this to 
enter the text after you have set the destination, or 
to go back to the text after editing some header 
field. : 


ae. mail—to 
Goes to the end of the "To:" line, to add a 
recipient. You are left here when the MAIL buffer is 
entered, to enter the first recipient. Then use “XA 
to continue. Separate recipients (like all header 
fields) with commas, e.g., 


TO? Smith.Sales, Consultant.c 
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“XY 


ESC “F 


ESC “B 


ESC “D 


en TD 


mail-from | 
Goes to the end of the "From:" line, to edit it or 
add more sender's names. 


mail-subject 
Goes to the end of the "Subject:" line, to edit it. 


mail-cc 

Goes to the end of the "Ce:" (carbon copy recipients) 
line, making one if there is none, so that you can 
type in the destination of a carbon copy recipient. 


mail-reply-to 
Generates a "Reply-To" field, if none exists, and 
goes to it. The destination put here is used for 
replies if a recipient of your mail uses RMAIL mode 
(or another mail system) to reply automatically to 
your message. 


send—the-mail 

sends the buffer to the recipients specified in the 
header. A message appears as a local display to 
confirm that the mail is sent (2 linefeeds to restore 
display). 


forward-mail-—field 
Moves forward one field (recipient, cc recipient, 
etc.) on this (header) line. Circles around at end. 


backward-mail-—-field 
Moves backward one field (recipient, cc recipient, 
etc.) on this (header) line. Circles around at end. 


delete-~mail-field 
Deletes, including necessary commas, the single 
header item (recipient, etc.) that the cursor is on. 


rmail—~logger-append 
Logs the message into a file, placing it at the end, 
separated by a formfeed. Prompts for the pathname of 
the log file with a numeric argument, or the first 
time it is used. Otherwise, uses the same file last 
used by “XL or “XP. 


rmail-logger-prepend 


Same as “XL, but puts message at the front of the 
file. 
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Three forms of recipient (or ce recipient) destinations are 
accepted: 


Smith.Sales (standard Multics Person.Project) 

Jones | (link mailbox in Daemon mailbox dir) 

Mxyptlk at KRYPTON-KL10 (ARPANET address, 
Person at SITE) 

Parenthetical comments in destinations are ignored, thus: 

Muhammad (I am the Greatest) Ali at (the) WBA 
gets sent to Muhammad Ali at site WBA. 

Net mail sending is done via the Network Mailer Daemon; net 
connect access is NOT required; you should be prepared for an 
acknowledgment message from the Mailer Daemon. 

Your name is given as: 


From: Smith.sSales 


or, if this site is on the ARPANET: 


From: Smith.Sales at MULTIX 
(Co If RMAIL knows your real name, your name is given as: 
From: sarah M. Smith <Smith.Sales at MULTIX> 
RMAIL is the mail reading mode. RMAIL knows your name if either 
your site Emacs expert has placed it in the 
"rmail-full—name-table" in the “emacs environment directory" (see 
him about this) or if you have a form setting "my-personal-name" 
in your startup, e.g., 
(setq my-personal-name "Sarah M. Smith") 
READING MAIL 
“XR 
Mail reading is performed via the request: 
“XR, rmnail 
By default, mail is read from your personal default mailbox. If 
“XR is given a numeric argument, e.g., “U°XR, the "mailbox name" 
C is prompted for. This may take any of the forms: 
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Person. Project 

<pathname> (with or without ".mbx" suffix) 

Person (if a link to Person.mbx exists in the 
ARPANET mailbox link directory) 


If you have no mail in the selected mailbox, a message is issued 
to this effect. Otherwise, the first message in the mailbox is 
displayed in a buffer, in RMAIL mode. This buffer is read-only; 
the following extra requests (all standard requests work here, 
too) apply in RMAIL mode(these are mostly not control characters, 
but regular characters): -— 


n rmail-go-forward 
Moves on to the next message. 


p rmail-go-backward 
Moves back to the previous message. 


1 rmail-go-first-msg 
Moves to the first message in your mailbox. 


1 rmail-go-last-msg 
Moves to the last message in your mailbox. 


g rmail-go-—command 
Moves to the message number specified by the numeric 
argument, e.g-., ESC 3 g to go to message #3. 


d rmail—queue-—delete-forward 
Deletes (i.e., queues for deletion when rmail is 
exited) this message, moves on to next undeleted 
message. 


D rmail-queue-—delete—backward 
Same as d, but moves backward. 


u rmail-undelete 
Brings back the last (stacked) deleted message. 


Cc rmail-—copy 
Copies the message to some other mailbox. Prompts 
for a mailbox name; anything acceptable to “XR (as 
above) is acceptable here. 


q rmail-quit . 
Quits out of rmail, returning to buffer from which 
rmail was invoked, deleting all messages marked for 
deletion. 


S rnail—summarize 
Summarizes (in a local display) all undeleted 
messages; may take a little time for full mailboxes. 
“XL rmail-logger-append 
Logs the message into a file, placing it at the end 
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of the file. see the description above under the 
mail-sending requests. 


( : “XP rmail-logger-prepend 
Same as XL, but "prepends" to the front. See the 
description above under mail-sending requests. 


r rmail-reply 
Formats a MAIL mode buffer to reply to the current 
message, copying the subject (if any), or making one 
up, and setting up as the destination the sender's 
"reply-to" address. Responses are not sent to other 
recipients. This request is extremely effective in 
2-window mode, in which case the response is put in 
the other window, and ESC “V (page-other-window) can 
be used to "page" the letter you are responding to as 
you respond. 


“X*Q rmail-quit 
Quits out of rmail, returning to the buffer from 
which rmail was invoked, deleting all messages marked 
for deletion. 


Once you have invoked the r request, you can use the MAIL 
mode requests as well as the standard Emacs requests. In 
addition, the following two requests are available: 


«3 “X°Q = return-to-rmail 
vo Returns to RMAIL and its window without sending the 
message. 


“x°S  send-from-rnail 
Sends the reply and return to RMAIL and its window. 


It is important to quit (q) out of RMAIL before leaving 
Emacs; Messages do not actually get deleted unless you quit out 
of RMAIL (or, equivalently, answer "yes" to "All messages 
deleted. Quit RMAIL?"). 
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APPENDIX ¢C 


PROGRAMMING LANGUAGE MODES 


Emacs, in addition to the Fundamental major mode for general 
editing tasks, provides four programming language major modes. 
Modes are sets of key bindings and variable settings; different 
modes allow more elastic environments for different editing 
problems. The Lisp, FORTRAN, PL/I, and ALM modes facilitate both 
programming in, and editing programs written in those languages. 


Each of these major modes is entered via an appropriate 
extended request (see the applicable paragraphs below) or via the 
“X°F request. Also, the following Fundamental mode requests that 
deal with comments have certain language-specific applications. 


Fundamental Mode Requests for Programming Use 


Most of the Fundamental mode requests listed below deal with 
comments. Programming languages generally each have a preferred 
column in which the programmer's comments begin, and this is 
called the comment column. Since the comments must be 
distinguishable from the program, they are delimited in some way, 
either by being begun and ended by certain character strings, or 
by being restricted to certain columns. The comment prefix is 
the comment's beginning delimiter. Several of the requests below 
use the comment prefix to recognize a comment. 


These comment requests are also useful in Fundamental mode 
for preparing two-column text. 


“x 


The “X; request, set-comment-—column, sets the comment column 
in the current buffer at the horizontal position where the cursor 
is currently located. With a positive numeric argument, sets the 
comment column at the column number specified. See ESC ; below 
for additional information. 
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The “Z; request, kill-comment, removes the comment and white 
Space preceding it from the current line. The deleted text is 
saved on the kill ring, accessible to Y. The text is saved in 
such a way that following “Ks and other torward-killing requests 
merge properly with the deleted text. 


ESC; 

The ESC 3; request, indent-for-—comment, searches for the 
current line's comment. If one exists, it indents it to the 
comment column in this buffer (set by “X;). If none exists, this 


request starts one at the comment column on this line. It uses 
the comment prefix to search for an old one or start a new one 
(see the extended request, ESC X set-comment-prefix). 


ESC N 


The ESC N request, down-comment-line, properly indents the 
comment on the next line, or puts a comment on the next line if 
none is there already. This is effectively the same as the 
sequence “N ESC ; (see ESC ;). 


ESC P 


The ESC P request, prev-comment-line, properly indents the 
comment on the previous line, or puts one there if none is there 
already. This is effectively the same as the sequence “P ESC ; 
(see ESC ;). 


ESC “B 


The ESC “B request, balance-parens-backward, skips backward 
over one set of balanced parentheses. It searches backward until 
a set of parentheses is found. However, it does not handle 
quoting or any programming language conventions. This cannot be 
used in Lisp mode, which has its own ESC “B function. 


ESC “F 


The ESC “F request, balance-parens-forward, skips forward 
over one set of balanced parentheses. It searches forward until 
a set of parentheses is found. However, it does not handle 
quoting, or any other programming language conventions. fhis 
cannot be used in Lisp mode, which has its own more powerful ESC 
“F function. 
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ESC X set—comment—prefix 


The set-comment-—prefix extended request sets the comment 
prefix in this buffer. The comment prefix is usually set 
automatically by entering amajor mode. However, it can be set 
by giving the comment prefix you want as an argument to this 
request. The argument must be in quotes, and should follow the 
request. The ESC ;, ESC N, and ESC P requests all use the 
comment prefix to find and start comments. 


ESC X set-compile-options 


The set-compile-options extended request sets non-default 
compilation options to be given to the appropriate compiler in 
language modes that support ESC “C for "compile buffer" (e.g., 
PL/I, FORTRAN). 


ESC X set-compiler 


The set-compiler extended request sets the name of the 
compiler to be used by the compile buffer request (usually ESC 
“C) in those language modes that compile buffers this way (e.g., 
PL/I, FORTRAN). The single argument to ESC X set-compiler is the 
compiler name. It must follow the request and be quoted. 


ESC ESC 


The ESC ESC request, eval-lisp-line, prompts for a string 
for Lisp to evaluate, parenthesizes it, evaluates it in Lisp 
(with ibase = 8), and displays the Lisp value in the minibuffer 
(base = 8, *nopoint nil). To get a variable value, type ESC ESC 
progn <variable name> CR. 


HSC X ldebug 


The ldebug extended request enters a "Lisp Top Level" buffer 
in Lisp Debug mode. Forms typed into this buffer are evaluated 
and the value is displayed by placing it in this buffer. When 
ESC X ldebug has been used, all Lisp errors in kmacs trap into 
this buffer. see the Extension Writers Guide for more 
information. . 


ESC X fundamental—mode 
The fundamental-mode extended request enters the mode that 


all buffers start out in. This request allows you to exit any 
other major mode that you may have entered. 
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The following paragraphs describe the programming language 
major modes and their special key bindings and variable settings. 


LISP MODE s. 


Lisp mode facilitates the construction and editing of Lisp 
programs in Multics Emacs. Requests for positioning over Lisp 
expressions, and indenting and commenting Lisp code are 
available. 


A facility within Emacs for debugging programs is available. 
It is called LDEBUG, and is described in the Extension Writers' 
Guide. 


Lisp major mode is entered by issuing the ESC X lisp-mode 
extended request, or by responding to “X°F (find-file) with any 
file with a last component name Or. *<lisp™ when the 
find-file-set-modes option is selected. When in Lisp major mode, 
the comment column is set to 50 (column 51), and the comment 
prefix to ";". The Fundamental mode comment requests, HSC P, ESC 
N, and ESC ; act according to these settings. 


The following is the current request repertoire of Lisp’ 


mode: | 

TAB (“I) indent—to-—lisp = 
On a blank or empty line, creates enough leading white 
Space so that the first S-expression typed on this line 
lines up properly according to conventional Lisp 
indenting rules. Normally, this means line it up with 
the start of the previous S-expression, but in other 
circumstances other actions may be taken. On a 
non—-blank line, readjusts the line's indentation to 
effect conventional Lisp indenting. 

ESC Q Lisp-indent~function 


Puts point and mark around the current Lisp function 
(see ESC “A). For all lines other than the first, 
re-indents them according to conventional lisp 
indentation. 


ESC 7A begin-defun 
Moves point to the beginning of the current "function". 
The beginning of a function is defined as right before 
the last open parenthesis at the left margin. 


ESC “B backward-sexp 
Moves backward over exactly one balanced S-expression. 
All comments, quoted strings, and slashified characters - 
are considered properly. Aborts (and beeps) if ) 
unbalanced. Avoid invoking this from inside comments ae 
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BSC 


ESC 


ESC 


ESC 


ESC 


ESC 


“C 


or quoted strings. Skips trailing open parentheses. 
Accepts numeric arguments for repetition count. 


compile-function 

Compiles and loads the current Lisp function via the 
Multics Lisp Compiler (lecp). Does this by writing it 
out into a process directory temporary, with special 
declarations in it, calling lcp to compile into the 
process directory, and loadfiling the (unique) object 
segment. Puts the name of the function compiled on the 
kill ring, so it can be yanked into an ESC ESC 
minibuffer for trial. Displays compiler diagnostics as 
local display. Be careful to write out changes you > 
make and debug via this facility; this is a common 
trap: you see what you have in front of you "working", 
and you think you are done. 


down-list-level 

Goes down one level of list structure. Basically the 
same as looking forward for an open parenthesis, but it 
detects and handles Lisp comments, quotes, etc. 


end—defun 

Goes to right after the last close parentheses of the 
current function. See begin-defun above for a 
definition of the current function. Useful to see if 
function balances parentheses correctly. 


forward-sexp 

Skips forward over exactly one S-expression, 
positioning to after the appropriate close parenthesis, 
or before the appropriate white space. Accepts numeric 
arguments for repetition count. Skips leading close 
parentheses. Avoid invoking inside quoted strings or 
comments. 


mark-defun 
Puts point and mark around the current function. See 
begin-defun for a definition of the current function. 


kill-sexp 

Kills one (or many) S-expressions forward, i.e., from 
point to the point after that many complete 
S-expressions. Argument is the number of 
S-expressions. Merges kills forward. 


CR (ESC “M) lisp-cret-and-indent 


Identical to a CR (newline) followed by indent-to-lisp; 
this is the normal way to terminate an input line in 
Lisp mode. It puts you ona new line and indents 
correctly for the next S-expression. Done in the 
middle of a line, it breaks the line at that point, 
correctly indenting the S~-expression which was to the 
right of point on the new line. 
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ESC “*Q 


ESC “R 


ESc “? 


ESC “V 


ESC “Z 


ESC & 


forward-list 
Moves to right after the end of current Lisp list. 
Basically, the same as searching for a close 
parenthesis, but detects and handles Lisp comments, 
quoting, etc. 


backward-list 

Moves to right before the beginning of the current Lisp 
list. Basically the same as searching backward for an 
open parenthesis, but detects and handles Lisp 
comments, quoting, etc. 


lisp-indent—region : | 
Re-indents all lines (other than the first) in the 
point-to-mark region for conventional Lisp indentation. 


move-defun—-to-screen—top 

Moves the current function (see begin-defun above for 
definition) to the top of the current screen, leaving 
point at function beginning. 


mark-sexp 

Puts point and mark around the current S-expression. 
If point is currently before the close parenthesis of a 
list, sets point and mark around that list. If point 
is before white space, marks the next S-expression. 


view-defun 

Prints out current function: puts point and mark 
around the current Lisp function (see begin-defun above 
for a definition), and displays it (prints it out, on 
printing terminals) as a local display. 


eval-—top—level—form 

Evaluates the current top level form and displays its 
value in the minibuffer. A top»level form has the same 
definition as a function. (See begin-defun above for 
the definition). Loads the file "e-macros.incl.lisp" 
to ensure the presence of the Emacs macros (see the 
Extension Writers Guide). This facility is intended 
LOT use in debugging extensions, as is 
compile-function, but runs your code interpreted rather 
than compiled to aid in debugging. Be careful to write 
out changes you make and debug via this facility 


Sets an LDEBUG breakpoint at the cursor (see the 
Extension Writers' Guide for more information). 
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The following extended request is available in Lisp mode: 


ESC X eval-buffer 

Evaluates the contents of the buffer and displays the 
value of the last form in the buffer via the 
minibutier. Loads the file e-macros.incl.lisp" to 
ensure the presence of the Emacs macros. This request 
is used to "load" a buffer of Lisp code into the Emacs 
environment for debugging. The eval-top—-level~form 
function (ESC ‘°*Z) can then be used to "reload" any 
functions whose definition you change while debugging. 
Be careful to write out changes you make and debug via 
these facilities. 


FORTRAN Mode 


Emacs FORTRAN mode aids in the construction and debugging of 
FORTRAN programs. Requests are provided for producing comment 
and continuation cards and for other commonly used formatting 
operations. 


FORTRAN major mode is’ entered by issuing the ESC xX 
fortran-mode extended request. This mode can also be entered by 
responding to “X°F (find-file) with any file with a last 
component name of ".fortran" when the find-file-set-modes option 
is selected. 


The current list of special requests in Fortran mode is; 


Carriage return (CR) new-line ! 
Returns the cursor to column /. This also inserts 
comment prefixes ("c ") in the appropriate places. 
If desired, the cursor can be moved back by hand to 
delete spaces or comment prefixes. 


mi fortran-indent-statement 
Causes a tab done in column 1 to tab to column 7. 
Subsequent tabs move to the usual places. The sequence 
for successive tabs is 7,10,20,30... 


ESC CR (ESC “M) fortran-continue 
Ends the current line when the next line is a 
continuation. A newline is done, unless the current 
line is blank or empty, and the prefix " & " is 
inserted, leaving the cursor in column 9. This is the 
continuation for standard FORTRAN rather than for 
Multics. 


ESC ; fortran-comment—line 
Begins a single comment line. A newline is done, 
unless the current line is blank or empty, and the 
prefix "c " inserted, leaving the cursor in column 
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7. This can be used to end a line when the next line 
is a comment. 


“XC fortran-begin-comment-—block = 
Begins a block of comments. Ends the current line, if - 
any, and inserts a comment block header line. Any 
future lines added are prefixed by the standard comment 
prefix ce ".« This minor mode is exited by a second 

XC. Notice that X C exits the editor. Don't miss 


ESC : fortran-label 
Positions a fortran label. Since a line usually starts 
in column 7, this request is provided to correctly 
position statement numbers. Type the statement number, 
then ESC : to place the label in column 1. 


ESC “C compile-buffer 

Compiles the buffer. Writes current buffer, if 
changed, out to its default pathname (as for “X"S), and 
then compiles it. Compiler diagnostics are displayed, 
in the other window if in two-window mode. The 
extended requests ESC X set-compiler and ESC X 
set-compile-options can be used to select the compiler 
and options to be used. 


x D locate-next-—error 

Finds the next error; used following a compilation in 
two-window mode. It scans the compiler output and the a 
source buffer in parallel, pointing a simulated cursor ») 
to consecutive errors and placing the real cursor on all 
the line referred to in the error message. This mode 
terminates itself when you advance past the last error, 

do another compilation, or exit it by keying “XT. 

Since this mode locks the buffer used for compilations, 

you are strongly advised to exit it when you are 
finished. 


fortran-abbrev-—expander 

Expands abbreviations. The two characters immediately 
preceding the cursor when this character is struck are 
taken as an abbreviation and expanded. The ' may 
itself be inserted by quoting it with ~“Q. These 
abbreviations are initially supplied: 


in integer su subroutine 
di dimension co continue 
fu function re return 

eq equivalence ex external 
au automatic: Cn common 

fo format im implicit 


Note that, with the exception of cn for common, all of 

. these abbreviations are the first two characters of the 
word. Other abbreviations may be defined using the eS 
extended request ESC xX £set-fortran-abbrev. The nema 
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abbreviations co (continue) andre (return) are very 
special. Since these words almost always have a label 
and sit on a line by themselves, these abbreviations do 
an ESC : and a newline, so that typing (in column 7): 
lZ25co:' 
expands to: 
25 continue 
leaving you onthe next line. The abbrev fo, for 
format, does labels, but not newlines. Try them. 
In addition, several extended requests are provided to set 
various parameters. They are: 


For comment blocks: 


ESC X fortran-set—begin-comment CR 
Sets the begin line. 


ESC X fortran-set—end-comment CR 
sets the end line. 


Both of these requests prompt for the line in the 
minibuffer. The line supplied is inserted exactly as given, and 
must therefore include the "c" at the beginning. Default values 
for these lines are: 

“eG SS S25 2> 55 S22 >S2 = 5555-52555 —2 2-5] S5S=2=", 


These are set by buffer. 


For compilations: 


ESC X set-compiler compiler-name CR 
Sets the compiler to be used. Default is "ft". 


ESC X set-compile-options options CR 
pets compile options. These are given as on the 
compiler command. The default is "-—tb". 


These are set by buffer. 


And, for abbreviations: 
ESC X set-fortran-abbrev abbrev expansion label eol 
can be used to define new abbreviations. In the above, 


abbrev must be a two character abbreviation that will 
be replaced with expansion. Arguments must be enclosed 
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in quotes if they contain special characters, including 
Spaces. The optional arguments label and eol cause 
this abbrev to handle labels and newlines, 
respectively, just like co and re. The label option 
does not require a label, but processes it if it is 
present. Abbreviations are defined globally and apply 
to all buffers in FORTRAN mode. For example: 


ESC X set-fortran~—abbrev as "common /xyz/ y(100)" eol 
defines an abbrev, as, that expands.to: 
common /xyz/ y(100) 


and does a newline, but does not handle labels. 


Currently, the recommended debugging method is to do a “*Z*Z ana 
run your program one level Ups Return to Emacs with a 
program interrupt command. 


PL/I MODE 


PL/I mode provides an automatic assistance in PL/I progam 
formatting in the real-time editing context of Multics Emacs. 
The basic facility provided at this time is that of lining up 
untyped PL/I statements, although on a one-for-one basis it lines 
up typed ones, too. 

& 


PL/I major mode is entered by issuing the ESC X pl1l-mode 
extended request, or by responding to “X“F (find-file) with any 
file with a last component name of Tape” when the 
find-file-set modes option is selected. It takes a couple of 
seconds to "load itself." When in PL/I mode, which shows up on 
the mode line as "PL/I" as a major mode, the following 
non-default key bindings apply: 


TAB (“I) indent-pl1-statement 
Indents this PL/I statement properly (if not yet typed 
in, tab out to it; otherwise, readjusts its indentation 
properly). 


ESC CR (ESC *M) pll-cret-and-indent 
Like carriage return and TAB. 


ESC *C compile-buffer 

Compiles the buffer. Writes current buffer, if 
changed, out to its default pathname (as for “X"S), and 
then compiles it. Compiler diagnostics are displayed, 
in the other window if in two-window mode. The 
extended requests ESC X set-compiler and ESC xX 
set-compile-options can be used to select the compiler 
and options to be used. 
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ESC * 


ESC * 


D plidel 

Tries to find a declaration for the entry point whose 
name is to the left of the cursor, and inserts it. A 
library of such entry points exists. If the 
declaration is not in the library, ESC *D attempts to 
figure it out from inbound parameter descriptors in an 
object segment responding to that name. Can also 
declare error table entries. 


H (ESC Backspace) roll-back-—pli-indentation 
Deletes 5 columns of indentation. Intended for 
undenting ends. 


ESC TAB (ESC “I) pl1-tab-one-more-level 


*X°D 


Adds 5 columns of indentation. Intended for asserting 
your own style. 


Locate-next-—error 

Finds next error. This request is used following a 
compilation in two-window mode. It scans the compiler 
output and the source buffer in parallel, pointing a 
Simulated cursor to consecutive errors and placing the 
real cursor on the line referred to in the error 
message. This mode terminates itself when you advance 
past the last error, do another compilation, or exit it 
by keying “XT. Since this mode locks the buffer used 
for compilations, you are strongly advised to exit it 
when you are finished. 


pli-—-comment—box 


Starts or ends a comment. Text following this is set 
off as a comment. <A second “XC ends the comment. 


All the standard commentation requests (ESC ;, etc.) are 


set for PL/I. Word requests (ESC F, etc.) in PL/I mode buffers 
consider the dollar sign to be part of a word. 


The indentation rules which are followed are: 


Any fragment of an incomplete statement gets lined up 5 
spaces after the start of that statement. The statement 
after a DO or BEGIN gets indented 5 times one less than the 
number of IF's in the DO or BEGIN. In "inding style 2", the 
statement after an end gets lined up 5 less than the end 
statement; the first statement in a program gets lined up at 
column 11 (Multics reckoning). Otherwise, each statement 
lines up with the previous one. | 


Two styles are available; the default is 1. You can get 2 


by saying ESC X opt pli-inding-style 2 CR (i.e., it is managed by 
the Emacs option mechanism). 
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In style 1, you get: 


if x = 6 then do: 
par = 5; 
O°: = 6; 
end; 


In style 1, you are expected to line the end up yourself (use ESC 
“H) because it is impossible in realtime to predict that an 
untyped statement is going to be an end. You must undent the end 
yourself, because the next statement lines up with it. 


In style 2, you get: 


if x = 6 then do: 


Dar = 5s 

foo: 24% 

end; 
next = 17; 


Emacs is happier with this, because it can figure out the next 
statement after the end once you have typed it. 


There are no known bugs in the mode's PL/I parsing: it can 
parse any valid PL/I statement, except that multi-dimensional 
label constants are not supported. (Multics PL/I does not 
Support them either). 


Electric PL/I Mode 


A minor mode called "electric PL/I mode" is available, which 
can be obtained by ESC X electric-mode CR once in PL/I mode, or 
ESC X electric-pli-mode CR. To get it by default as your mode 
for PL/I programs, put the statement: 


(defprop pl1 electric-pli-mode suffix-mode) 


in your start up-emacs. Some users have found electric PL/I mode 
overly violent, so it remains an option. It connects semicolon 
to a function which automatically indents for the next statement 
after inserting a semicolon; use °“Q; to get a semicolon in 
without the "electric" action. Also, this action is suppressed 
if there is a next line, and it is not empty. The “electric 
semicolon" also moves ends back for you (in inding-style 1), when 
you type the ";" of the end statement. (Be careful to quote 
semicolons with “Q in strings, or you may have problems.) 
Electric PL/I mode also gives ":" electric action, i.e., 
indenting after labels. 
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ALM MODE 


C. ALM mode provides several variable settings suitable for the 
“ creation and editing of ALM programs. 


ALM major mode is entered by issuing the ESC X alm-mode 
extended request, or by responding to “X°F (find-file) with any 
file with a last component name of ",alm" when the 
find-file-set-modes option is selected. 


In ALM mode: 

the comment column is set to 41 

the comment prefix is set to null 

the fill prefix is set to tab (a carriage return 


automatically indents to the opcode field of the ALM 
statement) 


In addition, carriage return is treated in such a way that 
extra fill prefixes and blank lines are deleted whenever 
possible. ALM mode also removes the indentation preceding labels 
typed before a colon. 
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APPENDIX D 


MACRO EDIT MODE 


The Macro Edit major mode is available for a number of 


purposes. With it, you can enter a dedicated buffer to: 


@ display a symbolic file of all named keyboard macros 
currently defined 


edit the displayed macros 
redefine macros after editing them 


write the macros out to a file, for dprinting, or for 
using them in later invocations of emacs. 


ENTERING MACRO EDIT MODE 


You enter the Macro Edit mode by issuing the ESC X 
edit-macros extended request, or by issuing the “X°F request to 
read in a, file with the .emacro suffix when the 
find-file-set-modes option is selected. This puts you ina 
buffer displaying, in editable form, all the macros that you have 
saved with ESC X save-macro. The display includes PL/I-like 
comments (/* comment */). The comment column in this buffer is 
automatically set to 51, and the ESC;, ESC P, and ESC N comment 
requests act accordingly. The macro definitions look like this: 


macro paragraph-stars on “X9 
esc-]| “XQ “0: Wh Pec See HN 
end-macro paragraph-stars 


The key setting, e.g., "on “X9," is optional. If present, it 
sets the key permanently, i.e., in all buffers, to that macro. 
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SDITING THE MACROS 


In Macro Edit mode, the following requests are available for 
editing the macros (they are designed to parallel Lisp mode): 


ESC 


ESC 


ESC 


ESC 


KSC 


ESC 


BSC 


ESC 


ESC 


ESC 


a 


A 


C2 


macedit-find-—beginning—of-macdef 
Moves to the beginning of the current macro 
definition. 


macedit~backward-term 
Moves backward one term in the macro. 


macedit-compile-to-lisp 

Compiles the macro being pointed at into Lisp (so 
that you get it permanently incorporated into 
Emacs). Many cases are not yet handled by the 
macro compiler, so you should not use this request 
unless you can verify that the Lisp code is 
correct. 


macedit-find-end-of-macdef 
Moves to the end of the current macro definition. 


macedit-forward-—tern 
Moves forward one term in the current macro 
definition. 


macedit-mark-whole-macro 7 
Puts point and mark around the current macro 
definition. 


macedit-kill-term 
Kills forward to the end of the current (or next) 
term in the current macro definition. 


macedit-forward-macdef 
Moves forward to the beginning of the next macro 
definition. 


macedit—backward—-macdef 
Moves backward to the beginning of the previous 
macro definition. 


macedit-state-keyboard—macro 

Prompts for a key and places the definition of the 
keyboard macro on that key in the buffer at the 
current point. 
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REDEFINING MACROS 


ESC *Z and ESC X load—-these-macros 


After you edit a macro, you can redefine it so that it works 
according to the new version, rather than the old. You must 
issue the ESC “2 request, macedit-take-up-—definition, while still 
in Macro Edit mode. It replaces the old definition of the macro 
being pointed at with the new definition just edited. If you do 
not issue this request (or the one below), the old definition 
continues to apply during this Emacs session. 


The ESC X load-these-macros extended request has the same 
actions and restrictions as ESC “Z; the difference is that it 
redefines all the macros in the buffer. So, if you edit more 
than one macro, this request is more convenient. 


WRITING MACROS OUT TO A FILE 

If you want to use your macros in later Emacs sessions, or 
if you want a printed copy of them, you must write the Macro Edit 
buffer's contents to a file. The “X°W request does this. If you 
write the macros out toa file whose suffix is ".emacro," 
however, subsequent “X“Fs on that file will automatically read it 
into Macro Edit mode, saving you a step. 


Using Macros Previously Written to a File 


ESC X load-macrofile 


When you write your macros out to a file, with or without 
the .emacro suffix, you can reuse the same macros in later Emacs 
sessions. They can be automatically defined in the current 
session if you issue the ESC X load-macrofile extended request. 
This request takes the pathname of the file containing your macro 
definitions as an argument; type the pathname after typing the 
command name, and end the prompt with a carriage return. 
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APPENDIX E 


USING EMACS ON PRINTING TERMINALS AND GLASS TELETYPES 


Emacs was specifically designed for use on intelligent video 
terminals, but you can use it on printing terminals and "glass 
teletypes." Glass teletypes have screens, but do not have cursor 
addressing or the usual display management capabilities e.g., the 
TELERAY 3700 and Honeywell Model 7700 Visual Information 
Projection system. If you are accustomed to using. Emacs, you may 
wish to use it on such terminals. Emacs also may have features 
and extensions that you wish to use that other editors do not 
offer. If possible, however, you should first learn how to use 
it on a video terminal. 


The usage of Emacs on a printing or glass teletype terminal 
is designed to be as close to video terminal usage as possible; 
all Emacs requests and features operate on any type of terminal 
(with the exception of specifically video-oriented features such 
as multiple-window mode). Thus, once you learn a sizable number 
of requests, or have perhaps written some keyboard macros or 
extensions, you can use them on any type of terminal. 


Printing terminals use the print-head or print-wheel (or 
actual cursor of a glass teletype) as a cursor. The single line 
of the buffer being edited upon which the point "appears" is 
always displayed, and the print-head is moved to the position to 
the right of the point, as is the cursor on a video terminal. 
Whenever you want to move the cursor to a new line, e.g., with 
the “N or “P requests, Emacs prints that line and repositions the 
cursor. If you move many lines at once, with a search, ESC G, or 
ESC <, for example, Emacs displays only the line on which the 
cursor "stops." If a line longer than the width of the terminal 


is to be displayed, all portions of it (i.e., the whole buffer 


line) are displayed. Once a line has been displayed in this 
manner, the print-head is moved to the point's position. As 
requests to move the point back and forth are issued, e.g., 

“F, ESC B, “A, the print-head moves around on the displayed line 
accordingly. Printing and glass teletype terminals are treated 
very much like video terminals with a one-line window. 
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When you invoke emacs ona printing or glass teletype 
terminal, Emacs prints the mode line. It is reprinted every time 
it changes. Similarly, the path line is printed every time it 
changes. Local displays are simply printed out (with a "More?" 
query when a glass teletype screen has been filled), followed by 
the reprinting of the current buffer line; no line of dashes and 
stars appears, and no linefeed is needed. A record of the local 
display appears on the terminal paper, or scrolls up the screen 
on the glass teletype. Messages normally destined for the 
minibuffer are also simply printed out; Emacs prompts are typed 
on a new line and the responses awaited. Enter the responses as 
usual, ending with a carriage return as usual. After you supply 
a response, Emacs displays the current line, and repositions the 
print-head appropriately. 


Typing a “L, redisplay-command, at any time prints the mode 
line, path line, and current line. 


Since only one buffer line is shown at once, you need some 
way to view many lines at once. Simply repositioning the cursor 
does this on video terminals. On printing terminals and glass 
teletypes, the “XV request, view-lines, fills this need ina 


manner similar to the "print" requests of line-oriented editors: 


like edm and gedx. The “XV request, with no argument, displays, 
as a local display, the current line. (Try this on a video 
terminal for tun!) With a numeric argument of zero, e.g., ESC O 
“XV, it displays a region; thus, “XH ESC O “XV displays the whole 
buffer. With any other positive numeric argument, e.g., “U “U 
“XV, it prints the specified number of lines (16 here) from the 
current line on down, and leaves you on the next line after them 
(type another “XV to see that line printed). With a negative 
numeric argument, the specified number of lines preceding the 
current line are printed. 


On avideo terminal, Emacs keeps the image of the buffer 
that is on the screen current by erasing and correcting text as 
requests are issued. Hardcopy terminals obviously cannot erase 
or correct what is already printed. Instead, whenever a line 
changes, Emacs performs a linefeed, scrolling the paper 
vertically, and prints the portion of the line that changed, and 
all of the line to the right of the change. Thus, deleting a 
character in the middle of aline prints all of the line 
following the deleted character on a new line. 


On glass teletypes, the modified right-hand portion of the 
line is simply rewritten in place (this also occurs on video 
terminals that do not support insert/delete characters), with no 
linefeed. 
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Typing or deleting characters inthe middle of a line 
creates a lot of output as the remainder of the line is 
continually reprinted. The continual repeating, besides being 
annoying, takes time, even on fully cursor-addressable video 
terminals that do not support insert/delete characters. Two 
techniques minimize this problem. 


The “X°T request, toggle-redisplay, suppresses all printing. 
If you issue a “X*T, all "updating", including seeing what you 
type (echoing) is inhibited. Another “X*T, or a “G or any error, 
performs all the updating at once and turns off the suppression 
of printing. You can see the current line by issuing a “XV; all 
editing changes that occurred while printing was suppressed are 
reflected. 


The second technique is to issue the “O request, open-lines, 
at the point in the line where you wish to make a change. This 
inserts a newline character, pushing the rest of the line down a 
line, and leaves you editing at the new "end" of the line. When 
you finish editing, a “D or “K deletes the newline and brings 
back the last part of the original line, reprinting it also. 


Bear in mind that a complex editing operation that affects 
many lines, e.g., ESC Q or ESC K, places the cursor wherever that 
particular request leaves it, printing that line out if it was 
not the last line printed. Other lines may change as well, but 
they are not printed. As on avideo terminal after a request 
that changes text over a large region of a buffer, the cursor is 
left as it is positioned at the end of the operation. An 
important difference is that you do not have a whole windowful of 
text surrounding the current line with which to reorient 
yourself. 


The best way to discover how Emacs works on printing 
terminals is to sit down at one and experiment with the various 
requests. You will soon become accustomed to the editing methods 
required. If your terminal is not one of the types specifically 
recognized by Emacs, invoke the emacs command with the 
"terminal type printing" control argument, or type the word 
"printing" when Emacs asks you for your terminal type. 
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Notes 


Very commonly, use of Emacs printing terminal support is 
accidental! If you are logged inon avideo terminal, your 
start up.ec or the person using the terminal before you may have 
incorrectly or inadvertently specified to Multics that you are 
using some type of hardcopy terminal. Then, when you invoke 
emacs, this misinformation is used, and you enter Emacs in 
printing terminal mode. This is indicated if, upon entry to 
Emacs, you find that the screen is not cleared, the mode line is 
displayed and scrolled up, the cursor is left on the line after 
the mode line, and attempts to clear the screen with “L repeat 
these actions. In this case, exit Emacs with “X°C as usual, and 
reinvoke emacs with the -query control argument. Emacs will 
query you for an acceptable terminal type (a ? or null response 
prints a list of acceptable terminal types), and reset it 
accordingly for the rest of the login session. Then, edit your 
start_up.ec if it caused the problem. 


A common problem encountered by those using Emacs ona 
printing terminal for the first time is that of characters 
appearing twice. This is always the result of a terminal's 
echoing characters locally. If this happens, exit Emacs and make 
certain that both your modem and terminal are set for full-—duplex 
operation. For terminals like the TermiNet 300, which have a 
controllable local printer, Emacs turns the printer off 
automatically, and this is not necessary. Otherwise, use full 
duplex (fulldpx) and echoplex modes, with a full duplex 
connection, modem, and terminal. This should be the case for 
video terminals as well as for printing and glass teletype 
terminals. 


Every video terminal can operate as a glass teletype. If 
you have a video terminal for which no support package (CTL) is 
‘supplied, glass teletype usage is preferable to printing terminal 
usage, Since lines are corrected by erasing and rewriting. Glass 
teletype usage is entered by invoking emacs with the 
-terminal type glasstty control argument, or by typing the word 
"glasstty" when Emacs asks you for your terminal type. You can 
use Emacs this way until a CTL can be constructed for your 
terminal type (see the Extension Writers' Guide for information 
on constructing CTls). In fact, this mode is useful for editing 
and debugging a new CTL until it works reliably. 
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APPENDIX F 


THE MESSAGE FACILITY 


You can receive interactive messages, sent via the Multics 
send_ message commands, while editing in Emacs. The ESC X 
accept-msgs extended request is provided so that those messages, 
which appear on your screen as a local display, are then 
conveniently saved in buffers from which you can respond to their 
senders. 


ESC X accept-msgs 


If you have not issued an ESC X accept-msgs request, or 
included it in your start_up, messages appear on your screen as 
Multics output, destroying the current display. If you do issue 
this request, however, it displays each incoming message, causes 
the terminal to beep, and enters the message into a buffer named 
"Messages from <Person name>. All correspondence to and from an 
individual is maintained in its own separate, appropriately named 
buffer. This request also provides the following response 
capabilities. 


“X: 


To respond to the sender of the last message received, type 
the “X: request, message-response command. Suppose Sarah Smith 
just sent you a message, you are prompted for your response to 
her in the minibuffer: 


To Smith: 


Type your message; when you type a carriage return, it is 
sent to Sarah. With this method, you remain in your current 
buffer, send the reply from there, automatically enter the reply 
into the Messages from Smith buffer, and can immediately resume 
your work. 
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With a numeric argument, “X: switches you to the message 
buffer of the last sender, so you can see the previous messages 
to and from that person, while you type a reply to them if you 
wish. Then you can “XB back to your working buffer. 


“xX! 


The “X' request, go-to-new-message-buffer, always switches 
you to amessage buffer. You are prompted for the name of the 
person whose message buffer you wish to enter: 


Messages to/from: 


You can type in the Person name (not Person.Project) of someone 
who already has a message buffer, i.e., they are or have been 
corresponding with you during the current Emacs session. You can 
give anull response to go to the message buffer of the last 
sender (as with “X: with a numeric argument). Finally, to 
Switch to the message buffer of a person not currently 
communicating with you, you give the name in the form of 
Person.Project (e.g., Smith.Sales), or Person at Net-Host-—Name 
(or Person @ Host). In any of these cases, you then simply start 
typing your message, and send it with your first carriage return. 


A further convenience of the message facility is its use 
with multiple windows. When the message buffers are on display, 
incoming messages are displayed immediately in their appropriate 
windows, without appearing as local displays. You can carry on 
several "conversations" at once, and can write any of the buffers 
out if you want a record of then. 
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APPENDIX G 


HMACS START-UPS 


Emacs can be instructed to execute a sequence of requests at 
the time it is invoked. This allows you to customize your 
environment, i.e., to set up things that are not provided by 
default. You do this with a file called an Emacs start-up. You 
do now need one: it is optional. If you do not have one, Emacs 
performs in precisely the manner described in this manual. If, 
however, you want to do things like enable the Emacs message 
system every time you use Emacs, you will want to have one. Your 
best bet in making a start-up is to copy someone else's and 
modify it. However, instructions for writing start-ups are 
provided here. 


Here is just about the simplest possible start—up: 


1 (accept-msgs) 
2 (default—-emacs-start-—up) 


The numbers on the left-hand side are not part of the file; they 
are here simply for reference. If you put these two lines in a 
segment called "start _up.emacs" in your home directory, Emacs 
will accept messages (i.e., activate the Emacs console message 
system described in Appendix F) every time it starts up. Note 
that there are two lines in this start-up: Line 1 invokes the 
ESC X accept-msgs extended request (just as though you had typed 
ESC X accept-msgs), and line 2 tells Emacs to go ahead and do 
everything it normally does when it starts up, such as read in 
the file whose name was given on the Emacs command line. The 
parentheses around each of these two "request names" (i.e., 
accept-msgs and default-emacs-start-up) tell Emacs that "this is 
something to do," i.e., that the name in parentheses is the name 
of an extended request to be executed. The request 
"default-emacs-start-up" must always be the last thing specified 
in a start-up, for everybody except advanced users attempting to 
use Emacs to implement specialized subsystems. 
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Here is a slightly more complicated start-up: 


; Sally's start-up 


(setq my-personal-name "Sarah M. Smith") 


1 

2 

3 (accept-msgs) 

4 

5 (default-emacs-start—up ) 


Line 1 is a comment. It has no meaning other than to let 
anyone reading the file know that this is Sally's start-up. The 
semicolon at the beginning of the line indicates that the rest of 
the line is to be ignored. Blank lines, such as line 2, also 
have no meaning, and are ignored. Line 2 is provided simply for 
readability. . 


On line 3, Sally activates the Emacs message system. 
Although this is the most common thing people want to do in 
start-ups, not everyone wants this to be,done, since those just 
beginning to use Emacs might not know how to use the Emacs 
message system. They should defer messages while using Emacs, 
instead of having messages destroy their screens. 


On line 4, Sally is telling the Emacs mail system (See 
Appendix B for a full description of it) what her "personal name" 
is; This is used by the send-mail request (°XM) for mail 
headers. When Sally uses RMAIL, she will get header lines like: 


From: Sarah M. Smith <Smith.Sales> 


in messages she sends. The "setq" is a keyword meaning "set the 
value of 2, variable," in this case the variable 
"my-personal—name." Variables are named boxes in which things 
are kept (you may have used Emacs text variables, which are 
manipulated by the “XX and “XG requests). The Emacs mail system 
looks in the box named my-personal-name for your full name, so 
this is the name of the variable you must supply. Note that 
Sarah's full name is between quotation marks; you must quote your 
name, so that its beginning and end can be determined. You must 
have a statement just like this in your Emacs’) start-up if you 
want the Emacs RMAIL system to know your full name when you 
compose mail. (Alternatively, you can request your site's Emacs 
expert to place your name in the "rmail-full-name-table," of full 
names of people at your site. He or she has been supplied 
instructions on how to do this when your site received Emacs). 


On line 5, as our earlier user did, Sally tells Emacs to do 
the usual things it does when starting up, after it has done all 
the things she asked it to do specifically for her. Again, every 
start-up must end by invoking "default-emacs-start—up.” 
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Once more, this text must appear in a segment named 
start up.emacs in Sally's home directory if Emacs is indeed to 
use it. 


A more complex start-up yet does the same things that 
sally's does, except that it is expressed in a form that allows 
for faster, more efficient execution at the time Emacs is started 
up. If your start-up does many things, you will want to do this 
to your start-up as well: 


sNick Romanov's start-—up 
;Function definition is used to make it execute faster 
;Petrograd 10/17 


1 
2 
3 
4 
5 (defun Nick-start-up () 

6 (setq my-personal-name "Nicholas A. Romanov") 
7 (accept-msgs) 

8 (opt 'find-file-set-—modes 'on) 
9 (default—emacs-start-up) ) 

10 
11 (Nick-start-up) 

As you know already, lines i-4 are simple comments, stating what 
this start-up is and where it came from. They have no meaning to 
tmacs and are ignored. You will recognize lines 6, 7, and 9 from 
the earlier examples. Line 6 sets Nick's name for use when he 
composes mail, line 7 activates the Emacs message system, and 
line 9 invokes the default actions that Emacs does when starting 
up without a start-up. Line 10 is blank, and is treated asa 
comment. Lines 5, 11, and 8 are explained below. 


Lines 5 and 11 are interesting ones. Line 5 says, "See the 
things on lines 6 to 9? They are a set of things to do." Line 9 
is the end of the set because of the last close-parentheses on 
that line, which matches the one at the beginning of line 5. In 
line 5, the name "Nick-start-—-up" is given to that set of things 
to do. That is what defun means, "define function." Thus, 
"defun Nick-start-up" means that the definition of a function, 
(i.e., aset of tasks to do) named Nick-start-up begins here. 
The fact that Nick coalasced all his start-up time tasks allows 
this "function" to be compiled for faster execution. The open 
and close parentheses ending the line, (), are necessary and must 
not be omitted: they mean that "Nick-start-up" has no arguments. 
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Line il of Nick's start-up says, "Do the thing called 
Nick-start-up" in the same way that line 1 of the first example 
says, "Do the thing called accept-msgs." It says to invoke, 
execute, or carry out the set of requests and commands that has 
the name "Nick-start-up," i.e., the set of commands and requests 
just defined. Why can they not simply be stated instead of 
assigning this name to them, as was done in the first two 
examples? You could, indeed, do this, but the function 
definition achieves increased efficiency. 





Note that lines 6 to 9 are indented, and line up with each 
other. This is stylistically proper for function definitions; 
Since extra white space is ignored, it is not strictly necessary. 


The name "Nick-start-up" is completely arbitrary. You 
should, however, call your start-up-function something like that, 
except substitute your own name for Nick. The name of the 
start-up function is not used anywhere except on the line (e.g., 
line 11 of the last example) that invokes it. It is not the same 
as “my-personal—name," and is not used by RMAIL. 


You may have been wondering about line 8. This is a request 
in Nick's start-up that invokes the ESC X opt extended request, 
described in Section 17. The particular line here: 


(opt 'find-file-set-—modes 'on) 
has the exact same effect as if Nick had typed: 
ESC X opt find-file-set-—modes on CR 


as soon as he had entered Emacs. The ESC X opt extended request 
is being used here to invoke the find-file-set-modes option, a 
very popular and common option that most users familiar with 
Emacs elect to have on. It causes automatic entry into PL/I mode 
when find-file (“X"F) is used to read in a PL/I program, FORTRAN 
mode when a FORTRAN program is read in, and so forth. It is not 
on by default, since a beginning Emacs user might not know how to 
use PL/I mode. New users should be able to edit PL/I (or any 
other language ) in Fundamental mode until they acquire 
proficiency in these special modes. 
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Any Emacs extended request can be invoked in this way from a 
start-up. You will note two differences between the way extended 
requests are issued to Emacs and the way they are stated in 
start-ups. First, instead of typing an ESC X, and ending with a 
carriage return, you put the extended request and its arguments 
in parentheses, as for accept-msgs (which had no arguments) in 
the first example. Second, you put the apostrophe character 
before all arguments to the extended requests (in this case, the 


extended request is "Ope and the arguments are 
"find-file-set-modes" and ren sean This is necessary to 
differentiate constant arguments (e.g., the keyword "on") from 
variables (e.g., a variable named "“on"). If you leave out the 


apostrophes, you receive anerror about undefined variables, 
which is in fact what you have specified. 


The opt extended request is by far the most common extended 
request to use in start-ups, other than accept-msgs. The full 
description of all of the options to the opt extended request may 
be found in Section 17. 


Compiling a Start-up 


As was mentioned before, start-ups may be compiled, i.e., 
translated into hardware machine language, to effect faster 
execution. Emacs start-ups ‘are actually computer programs 
written in Lisp programming language, a very powerful and 
flexible language, in which Emacs itself is written. More 
information about Lisp can be found in the Extension 
Writers' Guide. If you achieve proficiency in extension writing, 
you can vastly increase the power and sophistication of your 
start-up as well. 


However, to compile an Emacs) start-up, all you need to know 
is how to use the Lisp compiler. This is easy; it is just like 
any other Multics compiler. You invoke it, giving it a source 
segment in the Lisp language (an Emacs start-up as described 
above is such a segment), and it produces an object segment. 


To compile an Emacs start-up, this is what you must do: 


Vs Find out the pathname of the Lisp compiler froma 
knowledgeable person at your site. If your site has 
Emacs, it must have the Lisp compiler as well. Its 
name is lisp compiler, or lecp for short. It is 
probably in the same directory as the segment "lisp." 
If you have used Emacs in your process, use the Multics 
where command (type: wh lisp) to determine the name of 
this directory. 
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Prepare the Emacs start-up as described above, with. 
requests, function definitions, and comments in it. 
Write ar out to a segment (file) named 
"start_up.emacs.lisp" (make sure the name 


"start _up.emacs" is not on this segment, or you will be 
in danger of destroying it). 


Invoke the Lisp compiler: 
lisp compiler path 
where path is the pathname 
segment you 


underscores 
compiler. 


of the start-up.emacs.lisp 
just prepared; watch out for the 
(not hyphens) in the name of the Lisp 


The 
form: 


compiler may issue diagnostics. Warnings of the 


“my-personal—name undeclared -- henceforth assumed 
special" 
and : 


"(accept-msgs default—emacs-start—up opt) 
-functions referenced but not defined" 


are normal. Any other 
of an error. 
back to step 2. 


diagnostic may be an indication 
Check your start _up.emacs.lisp and go 


ae Assuming compilation 
object segment called 
might be expected) in 
rename it to start_up 
directory, making 
access. You now have 


sure 


was successful, you now have an 
start _up (not start _up.emacs, as 
your working directory. Copy or 
-emacs, and place it in your home 
you have read and execute 
a compiled start _up.emacs. 


It is not good to let others share your start-up, because of 


personal name in it: 


want to 


start-up's are 
use your start-up, 


personal. It your 


either prepare start-ups 


for them, or let them copy and edit yours. 
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MORE FEATURES YOU MIGHT WANT 

Below are some other lines you might want to put in your 
start-up, or take as examples. If you use them, or lines like 
them, they should be put wherever you put the rest of the 
requests you invoke at start-up time, either in your start-up 
function before "(default-emacs-start-up)" if your start-up is 
compiled, or standing alone before "(default-emacs-start-up)", as 
in the second example, if your start-up is interpreted (i.e., not 
compiled). In general, the order is not important, although 
"(default-emacs-start-up)" must be the last request executed. 


Here are the sample forms (the correct Lisp term for these 
requests): 


(and (eq tty-type 'vip7801)(set-screen-size 10.)) 


This says, "If I am using a (Honeywell) VIP7801 terminal, set my 
screen size to ten." The tty-type is a variable that contains 
the terminal type you are using -- the terminal type is just like 
the name of the terminal in the system's Terminal Type File, 
except it is all lowercase. The "eq" means "equal, the same as." 
The set-screen-size extended request is being used here, with an 
argument of 10. Note the decimal point: all numbers in Lisp are 
in base eight (octal) unless followed by a decimal point, which 
puts them in base ten, the base that people usually use for 
numbers. An apostrophe is not necessary before numeric 
arguments, but you can include one. Again, this is the same as 
if the user had issued the extended request: 


ESC-$X set-—screen-size 10 CR 


This form: 
(and (< ospeed 120.) (create-new-window-and-stay—here) ) 


says, "If I am logged in over a communications line operating at 
less than 120 characters per second (1200 baud), do a “X3 
(create-new-window-and-stay—-here), putting me in 2-window mode 
and leaving me in the first window." This is often what people 
want to do on low-speed lines, cutting down the amount of 
printout. Note that the command names (es a5 
create-new-window-and-stay—here) associated with 2. given 
keystroke (e.g., “X3), are useful in a start-up. 








In the above two examples, "ospeed" and "tty-type" are 
variables, and it is normal to receive warnings about them from 
the compiler, which will ‘Declare them special." These warnings 
can be ignored. 
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The form: 
(set~permanent—key ""“H" 'backward-char) 


is an example of a form that changes a default key binding. The 
person using this form wants the backspace (control H) key on his 
or her terminal to go backward a character (do what control B 
does). In this way, you can switch the assignment of any keys in 
your customized Emacs environment. The set-permanent—key 
extended request operates the same as described in Section 15 and 
creates all-buffer key bindings during the course of an Emacs 
invocation. 


Note that the circumflex and the H (not a real control H) 
are in quotes instead of behind an apostrophe. This is 
recommended for key names, which can contain special characters 
like semicolon or parentheses, which otherwise have meaning. 
When quotes are used, the apostrophe (') is not necessary. 


The form: 

(defprop pli electric-pli-mode suffix-mode) 
("defprop" is peculiar insofar as no quotes are needed on its 
arguments) says, "Invoke electric-pli-mode everytime a segment 
with a suffix of ".pli" is read in via “X°F." Thus, this elects 
electric PL/I mode as the mode to be entered for all programs. 

Similarly: 

(defprop compin fillon suffix-mode) 


says invoke fillon, i.e., enter fill mode, whenever a "compin" 
segment is read in. 
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POP-UP WINDOWS 


Emacs provides an option which causes windows to be created 
and destroyed dynamically as new buffers are switched into and as 
dedicated buffers are created and destroyed. This option causes 
new windows to. "Sprout" on various points of the screen, cutting 
up or removing old windows, or dynamically reorganizing the 
screen as new buffers are selected. One goal of this technique 
is to display simultaneously as many as possible of the things 
that you were working on recently by packing the screen full. 


This option, pop-up windows, is experimental; many Emacs 
users like it, and many do not. It can be turned on via the 
"opt" (option) extended request: 


ESC X opt po p-up-windows on 
and turned off similarly. It is off, by default. 


When in pop-up window mode, the standard window-selecting, 
creating, and destroying requests are used as in non-pop-up 
window mode. You will find that windows appear less frequently 
in pop-up mode if there is only one window on the screen to start 
with (the assumption is that if you have only one window, you are 
doing that deliberately), so it is often necessary to divide the 
screen yourself to get pop-up-windows “rolling." 


In pop-up window mode, requests that create or switch to a 
buffer create a new window if the buffer being switched to is not 
already on the screen. If the buffer is already displayed, these 
requests switch to the appropriate window. It is virtually 
impossible to get two windows displaying the same buffer in 
pop-up window mode. 
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INDEX 


MISCELLANEOUS 


# 8-2, 17-8, 17-26 
ruboutechar 43-2 


-line speed control argument 
k-2 


—query control argument A-1 
i aa ~reset control argument A-1 


-terminal type control 
argument A-—' 


@ 17-8, 17-11, 17-27 
kill-to-beginning-of—line 
ae, 


\ 
17-23 


\177 8-2, 17-8, 17-26, 17-28 
rubout-char 5-3 
see delete key 


escape-char 


abbreviations 
ESC X setab 17-35 
ESC X speedtype 17-35 


() accept-msgs, ESC X 17-34, F-1 


access 5=5 


alm-mode, ESC X 17-36, C—-12 


apropos, ESC X 11-3, 17-18 
asterisk 
in word searches 9-9 
special use of 3-1, 5-1, 
use in regular expression 


17-13 


backward=char, “B 3-4, 17-5, 
17-25 


backward-sentence, ESC A 
17-6, 17-29 


12-2, 
backward-word, ESC B 9-2, 
17-6, 17-27 


palance-parens-backward, ESC 
e, 17-8, C-2 


balance-parens-forward, ESC “F 
17-8, C=-2 


begin-macro-collection, “X( 


15-1, 17-24 


beginning-of-paragraph, ESC [ 
i225. 4715. "1450 
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blank lines 13-1 
descriptions of requests 
17-19 
list of requests 17-2 


bottomline 16-2 


break 17-16 


bufed buffer 16-8 
buffer 2-9, 10—1 
dedicated 16-5 
deleting 10-6, 16-9 
descriptions of requests 
17-51 
displaying multiple buffers 
16=1 
editing more than one 
editor 16-8 
requests 16-9 
list of requests 
listing 10-4 
main 2-9 
marking 10-6 
marking as unmodified 
modified 3-8, 5-1 
moving to ends of 
name 2-9, 5-3 
Switching 10-3 
windowstat 16-5 


10-2 


17-4 


1{-32 
10-2 


capitalize-initial-word, ESC © 
9-4 ? 1 7-28 


capitalizing words 9-4 


carriage return key 2-5, 


17-19 
center-line, ESC S 13-6, 
17-22 
character search mode 17-41 
clearing the screen 
after local display 10-4 


redisplay 10-5 
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command level 3-7, 5-2 

command name 3-2 -, 
command-quit, “G 6-2, 17-18 
comment 


column C-1 
descriptions of requests 


17-21 
list of requests 17-2 
prefix O-1, C2 
“Z3 17-10 
comout—command, “X*“E 17-16 


compiler C-3 

eonvuro. 
character 2-4 
key 2-4 


control argument A-1 


copy-region, ESC W 14-2, 

17- : 
correcting errors 3-2, 4-1 ef 
CR 

new-line 17-19 


see carriage return key 


create-new-window-and 
-go-there, “X2 16-3, 17-33 
-stay-here, “X3 16-3, 17-33 


cret-and-indent-relative, ESC 
CR 13-8, 17-20 


cursor 2-9, 3-1, 7-1 
movement 3-3 
descriptions of requests 
17-5 
list of requests 17-1 
customizing the Emacs 
environment G-1 
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dedicated buffer 16-5 
default pathname 5-5 
delete key 2-5 


delete-—blank-lines, *X*O 
17-10, 17-19 


15-2, 


delete-char, “D 
17-26 
delete-line~indentation, ESC ~* 

13-3, 17-20 


delete-white-sides, ESC \ 
13-2, 17-19 


delete-word, ESC D 9-4, 17-9, 
1'7=28 


deletion 4-2 
buffer 10-6 
descriptions of requests 

17-8 

indentation 13-3 
list of requests 17-1 
region ‘[~3 
sentence 12-2 
white space 13-2 
word 9-3 


describe, ESC X 11-4, 17-18 


describe-key, ESC ? 11-1, 


17=17 
directory editor 17~16 
dired buffer 17-16 


down-comment—line, ESC N 
17-21, C-2 


echoplex mode 2-5 


edit-buffers, “Z°B 17-32 
edit-dir, “XD 17-16 
edit-macros, ESC X 15-5, 
17-25 
edit-windows, “Z°W 17-34 
editing 
macro 15-5 


minibuffer | 3-8 


editor 
buffer 16-8 
directory 17-16 


macro D—| 
requests D-2 
window 16-5 


electric-pli-mode, ESC X 
17-36, C-12 


emacs command 2-8, A-' 
empty search string 6-2 


end-macro-collection, “X) 


15-1, 17-24 
end-of-paragraph, ESC ] 12-5, 
17-7, 17-30 
entering Emacs 2-8 
entering text 3-1 
error correction 3=2, 4-1 


error recovery 6-2 
descriptions of requests 
17-18 


list of requests 17-2 


ESC ~, unmodify-buffer 17-32 
BSC 3; 17-21 
indent-for-comment C=-2 
ESC 
escape 17-23 


see escape key 
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ESC # 17-9, 17-28 
rubout-word 9-3 
ESC @ 17-14 
query-replace 6-4 
ESC / 
regexp—search-command 17-13 
ESC < 17-7, 17-31 


go-to-beginning-of-buffer 


ESC <N> or ESC <=N> 
numeric argument 8-1 


go-to-end-of-buffer 


ESC ? 17-17 
describe-key 


10-2 


11-1 


ESC A 17-6, 17=+29 
backward—-sentence 


KSC B 17-6, 17-27 
backward-word 9-2 


12=2 


ESC C 17-28 
capitalize-initial-word 9-4 


ESC CR 17=20 
cret-and-indent-relative 
13-8 


ESC D 17-9, {7-28 
delete-word 9-4 


HSC E 17-6, 17-29 
forward—-sentence 


ESC ESC 17-37 
eval-lisp-line C-3 


12-2 


ESC F 17-6, 17-28 
forward-word 9-2 


ESC G@ 17-8, 17-27 
go-to-line-number 8-4 


ESC H 17-11, 17-30 
mark-paragraph i2=-5 


cee ne = re TT EL LT 8 EE LE TT CR parent iy 


ESC I 17-20 
indent-relative 13-7 = 
ESC K 17-10, 17-30 . 
kill-to-end-of-sentence 
12-3 
ESC L 17-28 
lower-case-word 9-4 
ESC M 17-19 
Skip-over-indentation 13-2 
ESC N 17-21 
down-comment-line C-2 
ESC P 17-21 
prev-comment-line C-2 
ESC Q 17=22 
runoff-fill-paragraph 12-5 
ESC R 
move-to-screen-edge 17-31 
ESC S 17-22 ie 
center-line 13-6 cy 
ESC U 17-28 - 
upper-case-word 9-4 
ESC Vo 17-7, 17-31 
prev-screen 10-1 
ESC W 17-12 
copy~region 14-2 
ESC X 17=24 
extended~command 11-3 
ESC X <command—name> 
see entries under their 
command—-names 
ESC Y 17-11 
wipe-this-and~yank-previous 
7-4 
ESC [ 17-7, 17-30 
beginning-of-paragraph 12-5 
ESC \ 17-19 my 
| Pa 


CH27-O00 


~, gSC \ (cont) 
! delete—white-sides 


a 
{ 5 


13-2 


ESC \177 17-9 
rubout-word 9-4 


ESC ] 17-7, 17-30 
end-of-paragraph 12-5 

ESC * 17=20 
delete-line-indentation 


c=? 


ESC’ “B 
balance-parens—backward 
1 7-8 ) C=—2 


ESC “F 
balance-parens-forward 


17-8, 


ESC *G 17-19 
ignore-prefix 6-3 
ESC “I 17-20 
C indent-—to-fill-prefix 13-7 
‘BSG 70-17-19 
split-line 


ESC “V 17-34 
page-other-window 


13-6 


16-4 


ESC *W 17-10 
merge-last-kills-with-next 
14=2 


ESC “Y 17-11 
yank-minibuf 


ESC _ 17-29 
underline-word 


17-10 


o= 


escape key 2-4, 17-23 
use for numeric arguments 


escape, ESC 17-23 
escape~dont-exit-minibuf “XESC 


C3 17-24 


cg er nr DFT IN NE TT 


escsape-—char, \ 17--23 
eval-lisp-line, ESC ESC 17-37,. 
C—3 
eval—-multics~command-—line, 
“XCR 17-16 
exchange-point-and-mark, “X°X 
7-3, 17-11 


execute-last-editor-macro, “XE 
15-2, 17-24 - 


executing a Multics command 
17-16 


expand-window-to- 
whole-screen, “X1 


bL=22 


16-3, 
extended request 11-2 
alphabetized list A-=+5 


extended-command, ESC X 
17~24 


11-3, 


extension writing 
descriptions of requests 


1 he | 


list of requests 17-5 
F 
file length 5-3 
filename 
inserting 17-16 
fill 
column 135-4 
“XF 13-5 
mode 13-4 
prefix 13-4, 13-7 
“ZX. 13=5 
filloff, ESC X 13-4, 17-22 
fillon, ESC X 13-4, 17-22 
CH27-00 


eee nemeenaiiel 
oT TT TT 


find-file, “X*P 5-3, 17-15 


formatting 12-5 
centering a line 13-6 
descriptions of requests 


17-21 | 
fill mode 13-4 
indentation 13-7 
list of requests 17-3 
two-column 17-21, C~1 
fortran—-mode, ESC X 17-36, 
C—7 
forward-char, “F 3-4, 17-5, 
17-26 
forward-sentence, ESC E 12-2, 
17-6, 17-29 
forward-word, ESC F 9-2, 17-6, 
17-28 
full duplex mode 2-5, H-4 
fundamental mode 2-8 
list of requests 17-1 
fundamental-mode, ESC X 17-36, 
C3 
G 
get-filename, “Z°F 17-16 
get-variable, “XG 14-3, 17-12 
glass teletype usage tI-1 
global requests 
BoC X replace i7-14 
“XS 17-14 
global-print-command, “xg 
17-14 
go-to-beginning-of-buffer, ESC 
¢ 10-2, 17-7, 17-31 


i-6 


go-to-beginning-of-line, “A 
3—6, 17-5, 17-26 


go-to-end-of—buffer, 
10-2, 17-7, 


ESC > 
17-31 
go-to-end-of-line, “E 3-6, 
17-5, {7-26 


go-to-line-number, 
Lies: died 


go-to-named=mark, “ZG 


17-12 


14-4, 


help 

descriptions of requests 

17-17 

ESC ? 11-1 

ESC X apropos 11-3 

ESC X describe 11-4 

ESC X make-wall-chart 11-4 a 

list of requests 17-2 ie. 

“41-5 — 
17-17 


help-on-tap, 11-5, 


ignore-prefix 
ESC “G 6—3, 17-19 
“X°G 6-3, 17-18 
“Z2°G 6-3, 17-18 
incremental search mode 17-43 
indent-for-comment, ESC ; 
17-21, C-2 
indent-relative, ESC 1l 13-7, 
17-20 | 
indent-to-fill-prefix, ESC “I 
13o=/5 17-20 
13-7 = 


indentation 


CH2'7-00 


TY SS AE | TE 


“Neer 


indentation (cont) 
deleting 13-3 
descriptions of requests 
17-19 
list of requests 17-2 
skipping over 13-2 
insert-file, “XI 14-1, 17-16 
inserting files 14-1 
interrupt 17-16 


ITS-string-search mode 17-41 


K 


key binding 2-8, 3-2, 11-1, 
1 


setting and changing 15-5 
15-6, 15-7 


keyboard 2-1, 2-4 
macro 15-1 


key name 


Kad) 
merging 4-3 
ring 4-2, 4-5, 12-3, 14-2 
successive 4-4 


kill-backward-sentence 
“X# 12-2, 17-9, 17-29 


“KX\I77) «12-3, 17-9, 17-29 
kill-buffer, “XK 10-6, 17-10, 
17-32 
kill-comment, ~Z; 17-10, 


17-21, CH1 


kill-lines, “K 4+2, 17-9, 
17-27 


kill-—to~beginning-of~line, @ 
5=—5, 17-8, Vir2t 


kill-~to-end-of-sentence, ESC K 
12-3, 17-10, 17-30 


{1 


ldebug, BSC X 
0-3 


17-37, 17-38, 


line 
centering 13-6 
shearing 13-6 
line number 8-4 
linecounter, “X= 5-3, 17-27 


linefeed key 2-4 
*J  10=4 


linespeed A-2 
lisp debug mode C-3 
lisp-mode, ESC X 17-36, C4 


list commara 5-2 


list-buffers, “X*B 
17-32 


10-4, 


list-named-marks, ESC X 14-5 


literal insertion 
descriptions of requests 
17-23 
list of requests 17-3 
of characters 3-6 


loadfile, ESC X 17-38 
loadlib,, ESC X 17-38 
local display 10-4, 14-3, 


14-5 
of a macro 15<4 
of a saved macro 15-5 
window editor 16-5 
with ESC ? 11-1 


logging in 2-6 
logging out 3-7, 3-9 


login command 2-6 


CH27=Q0 


PTS SRY TTY SS A PTT STA a HEA 


et er re hema Y 


logout command 3-7, 3-9 


lower-case-region, “X"L 9-6, 
17-12 


lower—-case~word, ESC L 9-4, 
17-28 


LRU window 
see window 16-2 


lvars, ESC X 14-3, 17-12 
M 


nacro 
creating 15-1 
descriptions of requests 

17-24 

displaying 15-4, 15-5 
editing 15-5 | 
executing 15-2 
including a query 15-~3 
list of requests 17-3 
Saving 15-4 


macro edit mode D1 
macro learn mode 15-1 
macro-query, “XQ 15-3, 17-25 


mail 
descriptions of requests 
17-34 
list of requests 17-4 
reading B-3 
sending B-1 


mail mode B-1 
main window 16~1 


major mode 2-8 
alm C~12 
fortran C-7 
fundamental 2-8, C-3 
list of requests 17-1 
lisp C-4 
lisp debug C-3 


major mode (cont) 
macro edit D-1 
mail B-t1 
pli C-10 | 
programming language modes 
C= 
programming languages 
descriptions of requests 
17-36 
rmail B-%3 


make=-wall-—-chart, ESC X 11-4, 
17-18 


margins 12-6, 13-5 


mark 7=2 

descriptions of requests 
17-11 

exchanging with point 7-3 
list of requests 17-1 
marking a buffer 10-6 
marking @ paragraph 12-5 
named 14-3 
setting [+2 


mark~paragraph, ESC H 12-5, 


mark-whole-buffer, “XH 10-6, 
17-11, 17=+32 


merge~last-kills—with—next, 
ESC “W 14-2, 17-10 


messages 
descriptions of requests 
17-34 
interactive F-1 
list of requests 17-4 


minibuffer 3-8 
editing 3-8 
ESC “Y 17-10 | 
setting its size 17-40 
“XESC 17-24 


Minor mode 2-8 
electric pli C-12 
fill 13-4 
macro learn 15-1 


CH27-00 


mode 
see major mode or minor mode 


modem 2-1, 2-5 


modified buffer 3-1, 3-8, 51 
ESC ~ 17+32 | 

move~to-screen-edge, ESC R 
17-31 

moving the cursor 3-3 

multi-word-search, “XW 9-8, 
17-13 | 

multiple buffers 10-2, 16-1 

multiple windows 16-1 


descriptions of requests 
17-33 
list of requests 17-4 


(multiplier, “U 8-4, 17-23, 


~ 


as / 17-35 


named mark 


14-3 
named region 14-2 
CR 17-19 


2-5, 3-1, 


new-line, 


newline 13=1 

next-line-command, “N 3-5, 
1 7-6 9 1 7-27 

next-screen, “V ie er ee 


17-30 


10—1, 


noop, “J 10-4, 17-23 
numeric argument 
ESC 8-1 
for executing macros 
negative 8-1 


15-2 


( | 
Meee 


ee eee ee eed a ST 


numeric argument (cont) 


positive 8-1 
“U 8-4 
O 
open-space, “O 13-1, 17-19, 
17-37 
opt 
paragraph definition 12-4 
pop-up-windows H-1 
opt, ESC X 17-38 
option, ESC X 17-40 


optional settings 
description of requests 
17-38 


list of requests 17-5 


page-other-window, ESC “V 
16-4, 17-34 


paragraph 
definition of 12-4 
descriptions of requests 
17-30 
formatting 12-6 
list of requests 
marking 12-5 


17-4 


parenthesis 
ESC “B 17-8 
ESC “F 17-8 


password 2-6 
D~) 


path line 5-1, 


pathname 5-1 
default 5-5 


pli-mode, ESC X 17-36, C-10 


CH27-00 





point 7-1 


pop-up-windows 16-1, H-1 


“X°R 17-15 


reading files 5-3 
descriptions of requests 


read~file, 


prev-comment—-line, ESC P t(=15 
17-21, C-2 list of requests 17-2 
prev-line-command, “P 34, ready message 2-7 
17-6, 17-27 
redisplay 10-5 
prev-screen, ESC V 10-1, 17-7, 
17-31 redisplay-command, “L 10-5, 
17-23, 17-31 
printing terminal usage FE-1 
descriptions of requests regexp-search-command, ESC / 
17-37 17-13 
list of requests 17-5 
region 7-1 
programming language modes capitalizing 9-6 
= copying 14-2 
descriptions of requests descriptions of requests 
17-36 17-11 
list of requests 17-4 list of requests 17-1 
named 142 
prompt 3-8, 6-1, 6-4 
regular expression 17-13 ae 
put-variable, “XX 14-2, 17-12 my) 
regular expression search mode — 
17-41 
Q 
remove-underlining-from-word, 
° 9-7, 17-29 
query 
macro—query, “XQ 15-3 remove-window, “XO 16-3, 
query-replace, ESC %@ 6-4 17-33 
query-replace, ESC 4 6-4, replace, ESC X 17-14 
17-14 
requests 3-2 
quit 17-16 alphabetized list A-2 
blank lines 17-19 
quit-the-editor, “X°C 3-7, descriptions 17-19 
17-16 buffers 17-4 
descriptions 17-31 
quote-char, “Q 3-6, 17-23 characters (moving 
by/deleting) 17-3 
descriptions 17-25 
R comments 17-2 
descriptions 17-27 
deletion 17-1 
re-execute-command, “C 8-3, descriptions 17-8 _ 
17-35 entry and exit 17-2 ) 
i-10 CH2'7-O00 


a RT reer A SP SS IF 


i. 


requests (cont) 
entry and exit 


descriptions 17-16 
error recovery i7/-2 
descriptions 17-18 
extension writing 17-5 
descriptions 17-37 
files 17-2 
descriptions 17-15 
formatting 17-3 
descriptions 17-21 
help 17-2 
descriptions 17-17 
indentation and white space 
17-2 , 
descriptions 17-19 
insertion 17-2 | 
descriptions 17-16 
lines (moving in and 
by/deleting) 17-3 
descriptions 17-26 
literal character entry 
17-3 
descriptions 17-23 
macros 17-3 
descriptions 17-24 
mail/messages 17-4 
descriptions 17-34 
marks, regions, variables 
17=1 
descriptions 17-11 
movements forward/backward 
17-1 
descriptions 17-5 
multiple windows 17-4 
descriptions 17-33 
new lines/blank lines 17-2 
descriptions 17-19 
optional settings 17-5 
descriptions 17-38 
paragraphs 17-4 
descriptions 17-30 
printing terminal usage 
17=5 
descriptions 17-37 
programming modes 17-4 
descriptions 17-36 
retrievals/yanks 17-1 
descriptions 17-10 
screens 17-4 
descriptions 17-30 


requests (cont) 
searches and substitutions 


17-2 
descriptions 17-12 
sentences 17-3 
descriptions 17-29 
Special purpose keys 17-3 
descriptions 17-23 
typing shortcuts 17-4 
descriptions 17-35 
words 17-3 
descriptions 17-2" 
reset-minibuffer-size, ESC X 
17-40 
reset-screen-size, ESC X 
17-40 
retrieving 


deleted text 4-2 
descriptions of requests 
17-10 


list of requests 17-1 
previous kills 7-4 
region ‘7-3 
reverse-string-search, “R 6-3, 
17-12 
rmail mode B-3 
rmail, “XR 17-34, B-3 
rubout~char 
# 3-2, 17-8, 17-26 
\177 3-3, 17-8, 17-26 
rubout-word 
ESC #f 9-3, 17-9, 17-28 
ESC \177 9-4, 17-9, 17-28 
runoff—-fill-paragraph, ESC Q 
V2=5¢ 17-22 


runoff-fill-region, ESC X 
17-23 


CH27-00 





Save-macro, ESC X 


15-4, 17-25 
Save-same-file, “X°S 5-5 


screen 2-1 
see window 


scroll-current-window, *Z*V 


17-31 


searching 6-1 

character 17-41 

descriptions of requests 
17-12 

incremental 17-43 

ITS-string 17-41 

list of requests 17-2 

printing lines containing a 
given string 17-14 

regular expression 17-13, 
17-41 

setting search mode 17-40 

string 6-1, 6—4, 17-41 

with * 9-9 

word 9-7 


select-another-window, “X4 

16-4, 17-33 
select-buffer, “XB 
17-32 


10-3, 


select-other-window, “XO 16-3, 


171-33 
16—1 
17-34, B= 


selected window 


send-mail, “XM 
sentence 
definition of 12-1 
descriptions of requests 
17-29 
list of requests 17-3 
set-comment—column, “X; 17-21, 
C1 


1-12 


set-comment-prefix, ESC X 


17-21, C-2 

set-compile-options, ESC X 
17-36, C—3 

set-compiler, ESC X 17-37, 

set-fill-column, “XF 13-5, 
17-20, 17=22 

set-fill-prefix, *X. 13-5, 
17-20, 17-21 

set-key, ESC X 15-5, 17-40 

set-minibuffer-size, ESC xX 
17-40 

set-named-mark, “Z°@ 14-4, 
17-12 

set-or-pop-the-mark, “@ 7-2, 
17-11 

set-permanent-key, ESC X 15-5, 
17-40 

set-screen-size, ESC X 17-40 

set-search-mode, ESC X 17-40 


ESC X 17-35 


setab, 


show-last-or-current—macro, 


“x* 15-4, 17-24 
show-macro, ESC X 15-5, 17-25 
Signalquit, “Z2°Z 17-16 


skip-over-indentation, ESC M 


13-2, 17-19 
speedtype, ESC X 17-35 
speedtypeoff, ESC X 17—36 
split-line, ESC *O 13-6, 
17-19 
CH27-00 


Pata | 

. s 
7 
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' 
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\ 

‘ od 











res ae oo cere ae 8 eer praesent SSP 


start-up G-'1 
17-41 


~  gtring search mode 
string-search, “S 6-1, 17-13 


substitution 6-4, 17-14 


successive kill 4-3 


syllable 15-6 


terminal 
-ttp control argument A-j 
glass teletype k-1 
printing terminal usage E-1 
descriptions of requests 
17-37 
list of requests 17=5 
requirements 2-5 
types 2-8 


(text entry 3-1 


toggle-redisplay, “XT 
E-3 


17-37, 


topline 16-2 


transposing characters 
T 17-35 


twiddle-chars, “T 17-35 


underline-word, ESC _ 
17-29 


9-7 ’ 


underlining words 9-6 


unmodify-—buffer, ESC ~ 17-32 
updating 
suppressing 17-37 


Cc. 


. so 


upper-case-region, “X*U 9-6, 
17-12 


upper-case-word, ESC U 9-4, 
17-28 


User_id 2-6 


V 
variable 14-2 
descriptions of requests 
17-11 
list of requests 17-1 
view-lines, “XV 17-37, E-2 
W 
white space 13-1 
deleting 13-2 
descriptions of requests 
17-19 
list of requests 17-2 


window 2-9, 5-4, 10-1 
creating additional 16-3 
descriptions of requests 

17-30 
editor 16-5 
requests 16-7 
least recently used (LRU) 
16-2 
list of requests 
main 16-1 
multiple 16-1 
paging multiple windows 


wee 


removing 16-3 
repositioning 

ESC R 17-31 
scrolling 

“Z2°V 0 17-31 
selected 16-1 
selecting 16-3 
setting its size 17-40 


windowstat buffer 16=5 


CH27—-O00 





ae ee AD | 


“W [-3, 17-9, 


wipe-region, 
17-12 


wipe-this-and-yank-previous, 
BSC Y 7-4, 17-11 


word 
capitalizing 9-4 
definition of 9-1 
descriptions of requests 
17-27 
list of requests 
underlining 9-6 


iT=5 


write-file, “X°W 5-1, 17-15 


writing extensions 
descriptions of requests 


17-37 
list of requests 17-5 
writing files 5-1, 5-5 


descriptions of requests 
17-15 


list of requests 17-2 


3 


yank, “Y 4-4, 17-10 


yank-minibuf, ESC “Y 
17-11 


17-10, 


see control key 


“@ 82 
set-or~pop-the-mark ‘/-2 


17-5, 17-26 
go-to-beginning-of-line 


“B 8-2, 17-5, 
backward—-char 


“A 
17-25 
3~4 


“C 17-35 


3-6 


“0; eon’) 
re-execute-command 8-3 
“D 8-2, 17-8, 
delete-char 


17-26 
4—2 

“ 17-5, 17-26 
go-to-end-of~line 3-6 
“F 8-2, 17-5, 
forward-—-char 


8-3, 17-18 
command-—-quit 


17-26 
3-4 
“G 
6-2 

“J 17-23 
noop 10-4 


“K 4-5, 8-2, 
kill-lines 


17-25, 1f-51, E-2 
redisplay-command 


8-2, 17-6, 17-27 
next-Line~command 43=5 


17-19, 


open-space 


17-9, 
4-2 


17-27 
“L 
10-5 
“N 


ue @ 17-37, B-%4 


135—1 


“P 8-2, 17-6, 17-27 
prev-line-command 3-4 


17-23 
quote-char 


“Q 
3-6 
“R 17-12 

reverse-string-search 


“S 17-13 


string-search 6-1 
al 
twiddle-chars 


17-23, 17-35 
multiplier 8-4 


I(2)> 
“U 


“V 17-7, 1'7~+30 


next-sereen 10-1 


“W 17-9, 17-12 


6~3 


“W (cont) 
wipe-region 


OO) 7-3 
“X; 17-21 


set—-comment-column C-1 


a 4 
show-—-lLast-or-current-macro 


15-4 


“X# 17-9, 17-29 


kill—-backward-sentence 12-2 


“X( 17-24 


begin-macro-collection 15-1 


“X) 17-24 


end-macro—collection 15-1 


“X* 17-24 

“X. 17-20, 17-21 
set-fill-prefix 13-5 

"kO TT =55 


remove-window 


eG ns eo 
expand-window-to-whole 
-screen 16-3 


“X2 17-33 
create~new-window-and 
-go-there 16-3 


“X35 17-33 
create-new-window-and 
~Stay-here 16-3 


“X4 17-33 


select-another-window 


16-3 


16=4 


“X= 17-27 
linecounter 5-3 
“XB 16-8, 17+32 


select-buffer 10-% 


“XCR 
eval-multics-—command-line 
17-16 


“Sewer 6" 


a a EN EA 


a 


a 


oa 


a 


a 


a 


Pay 


aA 


a 


“a 


Pad 


“aA 


aA 


a 


na 


n 


nm 





XD 
edit-dir 17-16 
XE 17-24 
execute~last—-editor-macro 
15-2 
XESC 
escape~-dont-—exit-—minibuf 
17-24 
XF 17-20, 17-22 
set-fill-column 13-5 
kG 17-12 
get-variable 14-3 
XH 17-11, 17-32 
mark-whole-buffer 10-6 
XI 17-16 
insert-file 14-1 
XK 17-10, 17-32 
kill~buffer 10-6 
XM 17-34 
send=mail B—1 
XO 17-53 
select-other-window 16-3 | 
XQ 17-25 
macro-query 15-3 
XR 17-34 
rmail B-%4 
X$ 
global—print-command 17-14 
XV E=2 
view-lines 17-37 
XW 17-13 | 
multi-word-search 9-8 ! 
XX 17-12 
put-variable 14-2 : 
X\177 17-9, 17-29 
kill-backward=-sentence 12-3 
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“X°B 17+32 
list-buffers 10-4 


“X"C 17-16 
quit-the-editor 3~7 


“X°E 


comout-—-command 17=+16 


“X°P 10-2, 16-8, 17-15, C4, 
C-7, C-10 
default pathname 5-5 
find-file 5-3 


“X°G 17-18 
ignore-prefix 6-3 


“X°L 17-12 
lower-case-region 9-6 


“X°O 17-10, 17-19 
delete-blank-lines 13-2 


read-file 17=15 


“X"*S 8-5 
save-same-file 5-5 


“X°T E-3 


toggle-redisplay 17-37 


“X°U 17-12 
upper-—case-region 9-6 


“Z°W 8-5, 17-15 
default pathname 5-5 
write-file 5-1 


“X°X 17-11 


exchange~-point—-and-mark 7-3 


“Y 7-3, 8-2, 17-10 
yank 4-4 


“ZL; 17-21 


kill-comment 17-10, C1 


“ZG 17-12 
go-to-named-mark 14-4 


“Z°@ 17-12 


“Z"°@ (cont) 
Set-named-mark 14-4 


“Z"B 17-32 
edit-buffers 16-9 
get-filename 17-16 
“Z2°G@ 17-18 
ignore-prefix 6-3 
scroll-current-window 1731 
“ZW 17-34 
edit-windows 16-6 
ay 
Signalquit 17-16 
“Z  -17=29 
remove~underlining-from-word 
9-/ 
“17-17 
help-on-tap 11-5 
“2? 141-5 
TA 11-5 
~D 11-5 
““H 11-5 
“TD 11=<5 
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